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Fed up of DIGITAL PRECISION telling 
you how very good their software is? 


vf "As you might surmise by this time, I am impressed by QMATHS's abilities. Having 
noted that DIGITAL PRECISION’s advertising tends to be loaded with superlatives 
(incredible, ultimate, superb come to mind), | had approached this evaluation with 
some scepticism. That scepticism has vanished." > INTERNATIONAL QL 
REPORT (IQLR, available from Miracle Systems) May/June 1993 issue, Official Review 
by M.Laverne commissioned by IQLR (who bought their review copy of the program). 
J "PERFECTION is an exciting, full-flavoured, general purpose word processor of 
incredible capacity... PERFECTION has now been outshone by the recently released 
PERFECTION SPECIAL EDITION... The discoveries began to trip over themselves as 
PERFECTION SE responded to the keyboard with unexpected speed and 
intelligence... PERFECTION SE is blindingly fast at most things, and you are never 
left waiting for it. PERFECTION is everything that Quill never became: easy to use, 
very flexible, loaded with genuinely useful features, cleanly multi-tasking, capacious 
and incredibly fast. The SPECIAL EDITION offers 12 cylinder power and luxury to an 
already impressive package." > SINCLAIR QL WORLD magazine Official Review, 
Pr 1993 issue, by THE Mike Lloyd of Keyword Index / New QL User Guide fame. 
"I find PROFESSIONAL PUBLISHER an outstandingly good program that really 
does allow highly professional documents to be produced. For your interest ] have 
included a few samples of work done for school using a combination of PERFECTION, 
PROFESSIONAL PUBLISHER, QUICKLASER and EYE-Q. You will be pleased to 
know that the quality has been rated so highly that people do not believe it can really 
have been done with just a QL... I must stress that I am already highly impressed with, 
and very satisfied by, the performance of PROFESSIONAL PUBLISHER and all the 
other DP programs that I use... I seem to learn something new that can be done 
almost each time I use the program. Very many thanks for helping to keep the QL 
ahead of the field." > Martin J Neave, Headteacher, Watton County Jnr School, 
Brandon Rd, Watton, Norfolk, IP25 6AL (unsolicited letter dated 18 May 1993 
ae more programs: Mr Neave had paid full price for everything). 
"l IGHTNING SPECIAL EDITION accelerates QL operation as nothing else does... 
more than 10x is achievable and 2x-4x is typical... I could not fault LIGHTNING 
SPECIAL EDITION on anything. It is a clear winner and a best buy at £49.95." > 
‘SINCLAIR QL WORLD magazine Official Review, April 1990 issue, by Ron Massey, 
who wrote EDITOR (bought full price) was "Superb" in an earlier review. 


"PERFECTION is well named" > R.H.Petford, Kingston Hill, Surrey, KT2 7LJ 
(unsolicited letter received May 25, 1993: another full price purchaser & upgrader). 


"When my ideal program finally arrived in the form of PROFESSIONAL 
PUBLISHER, it surpassed all my expectations... PROFESSIONAL PUBLISHER (is) in 
a class of its own, and makes it the only QL desktop publishing program for the very 
serious user... Until Digital Precision released PROFESSIONAL PUBLISHER, my 
opinion was that the use I could make of desktop publishing was mainly restricted to 
short documents... PROFESSIONAL PUBLISHER is a very versatile program... The 
illustrations for this series of articles have all been produced on PROFESSIONAL 
PUBLISHER... My printer is a BROTHER 9-pin dot matrix printer. It does illustrate 
the very high quality that can be obtained from PROFESSIONAL PUBLISHER even 
when using a simple printer." > SINCLAIR QL WORLD magazine Guide to desktop 
publishing ("A Question of Dots"), January 1992 to December 1992 issues: the 
reviewer had bought PROFESSIONAL PUBLISHER, PERFECTION SE, FONT 
E RGER, TOOLBOXES, QUICKLASER etc from Digital Precision all at full price. 

"I am aware that over the years Digital Precision has given considerable support to 
the QL scene but seldom, if ever, can there have been such estimable service as | 
recently encountered with PERFECTION PLUS." > The Hon. W.D.R. Spens, 
Bridgewater, Somerset, TAS 1HG, QUANTA magazine, March 1992 issue. Mr 
Spens has bought a lot of his software from Digital Precision, all at full price of course. 

"The Digital Precision Desktop Publisher was rightly hailed as an extraordinary 
programming achievement when it was released two years ago. Mike Lloyd casts a 
professional eye over Digital Precision’s latest page-making blockbuster 
(PROFESSIONAL PUBLISHER, and finds plenty to be pleased about... there is 
unlikely to be a single program of such magnitude and quality (as PROFESSIONAL 
PUBLISHER) written for the Sinclair QL." > SINCLAIR QL WORLD Official 
5 ge August 1989 issue, by M.Lloyd, who personally bought all this at full price. 

"EDITOR is a liberation. After Quill, it was like jumping from an aquarium into the 
sea. It-has become part of my professional life... Everyone is now writing about the 
excellence of PERFECTION. I have not tried it, not having any perceived need for it 
(having EDITOR)' > Suzanne Cronje, QUANTA magazine, May 1992 issue, page 2. 

Cronje naturally had paid the full price for her copy of EDITOR SE etc. 

"I have found (PERFECTION) to be simply excellent, fast, packed with features 
and very well thought out. I can find little to say that will convey just how good this 
program is, except to quote Digital Precision’s own advertising: PERFECTION will 
blow your socks off. PERFECTION is the program that Quill users have been 
waiting for." > SINCLAIR QL WORLD’s first Official Review, May 1991 issue. 

"Digital Precision (DP) decided to begin work on a replacement for Quill which 
would be very quick, simple to use and contain lots of excellent features - something 
upon which DP have built a very strong reputation in the QL market... Overall, the 
speed-up (of just the first release of PERFECTION - it is much faster now) on even a 
humble QL with Trump Card is amazing when compared with Quill (or any other 
word processor). On top of this, the program provides many excellent and well 
thought out features, each of which is easy to use... (i) is certainly years ahead of the 
competition on the QL (and even on many PCs)." > R.Mellor, c/o CGH Services, 
Cwm Gwen Hall, Pencader, Dyfed, SA39 9HA; Official Review of the very first 
version of PERFECTION in QL TECHNICAL REVIEW issue 7: and the reviewer 
personally bought his own copy of this program, and many others at full price, from 
Digital Precision. Earlier QLTR reviews pronounced LIGHTNING (just the standard 
ee superior to the competition and ADVENTURE CREATION TOOL excellent. 


"PERFECTION SE is superb!! With Gold Card, it puts life in the fast lane. Thanks." 
> Leonard Singleton, Bletchley, MK3 6BP, June 1993, a full price purchaser (=fpp). 


vA "As a recent user of PERFECTION PLUS SE, may I add my thanks and praises to 
the ones I am sure you have already received... keep up the excellent work." > R 


a uae East Molesey, Surrey, KT8 OBP(unsolicited letter from full price purchaser). 
"At about 360,000 words, the Mega SPELLCHECKER dictionary does not have 
much competition, on any computer! (Spellchecking) is about four times as fast as the 
best figures | have seen with other checkers on QL and PC." > SINCLAIR QL 
WORLD magazine official review of PERFECTION spellchecker, September 1992 
issue, by Bryan Davies of Troubleshooter repute (review copies of all the competing 
products supplied to SINCLAIR QL WORLD by their respective publishers). 

"In the past I have purchased a number of your programs and have never failed to 
be impressed by the quality of both product and documentation. (So) please send a list 
ha current products." > V.Negri, Hempton, Norfolk, NR21 7LF, June 1993, fpp. 

"This is my first letter with PERFECTION SE. I must say I'm impressed with it and it 
is certainly fast. Hooray, goodbye to Archive!" > P.H.Heilbron, Reigate, RH2 ODJ, a 
4 price purchaser now using PERFECTION to replace not only Quill but Archive too. 

"T have been using PROFESSIONAL PUBLISHER for about eighteen months now... 
what you can do with it is colossal... | got Digital Precision’s QUICKLASER. The 
results are as good as (Digital Precision) says in its advertisements..." > P.Hamill, 
Peterborough, Cambs, PE8 6RH, QUANTA magazine, Volume 9 issues 4/12. Mr 

mill (full price purchaser) then makes suggestions to users re optimal page sizes. 

"Once again I would like to say thank you for your help. I would like to tell the 
world what nice guys you are but unfortunately I have no contact with the outside 
world." > J.Bailey, Godshill, Ventnor, PO38 3JJ (full price purchaser, 24 May 1993). 
v "PC CONQUEROR GOLD SPECIAL EDITION is an excellent product, 
accompanied, as so often with Digital Precision software, by a comprehensive and 
informative manual. The program does a difficult job, and does it well... Overall, this 
program is much faster, more compatible and capable..." > SINCLAIR QL WORLD 

ficial Review, March 1993 issue, by M.Knight (bought many DP programs full price). 

"With printing of the quality that this page bears witness to, | am a very satisfied 
PERFECTION user. I hope that you continue to provide the software innovation and 
the accessible backup which is great. So, thank you very much again and may | wish 
ygu every good fortune." > P.Stewart, Temple, London, EC4Y 9BE, 10 May 1993, fpp. 
“i, "Many thanks for the update of PERFECTION SPECIAL EDITION. I am suitably 
impressed. Congratulations on producing the only word processor that I know that 
offers the best of all worlds as far as formatting is concerned. After Quill, 
PERFECTION is like a breath of fresh air." > Geoff Wicks, 1097HL Amsterdam, 
Netherlands (unsolicited letter dated 13 June 1993: all software including LIGHTNING 
a ae SE, PRO PUBLISHER, CONQUEROR SE etc. purchased at full price). 


‘All | can say about QMATHS is: WOW!" > Robin Wyke-Holloway, Salisbury, SP5 
AWG (unsolicited letter received April 1993: Mr Holloway is a full price purchaser). 


"I have had PERFECTION from the early days and have had many hours pleasure 
finding out more and more of its brilliant features. May | offer my congratulations on 
such an easy to use program which does everything I want - and more besides." > 
eee Pinner, HA5 5AZ, fpp, thanking us for fixing a printer problem he’d had. 

"Having used a range of desktop publishers on the Atari ST & Amiga, | admit | am 

very impressed with the superior performance of PROFESSIONAL PUBLISHER. It 
contains everything required" > SINCLAIR QL WORLD January 1989 issue, article 
entitled "Six of the Best" which also praised five other new Digital Precision programs. 
J "I find it difficult to express my gratitude for the speed of your response, and for 
the opportunity to see inside two excellent programs w ich I have long enjoyed using." 
>,Richard Walker, Enniskillen, BT74 7LG, full price purchaser and QL expert. 
J "May I take this opportunity to say that I have, in the past, found the software you 
have supplied me with (LIGHTNING etc.) to be of extremely high standard, on a par 
with that found in industry-standard PC packages. Keep up the good work. Without 
your quality software, | would be forced to abandon the QL and go to a PC." > G. 
Reynolds, Crosby, Liverpool, L23 0SS (unsolicited letter dated April 2 1993, placing a 
further order for DP software: all programs old & new were purchased at full price). 


This is but a casual selection, drawing only on extracts from recent letters and reviews. 
We could locate >1000 complimentary communications but we’d prefer to spend our time 


producing new programs! We refer potential customers (existing users of DP products already 
know how good they are) to pages 18/19 of the September 1988 issue of Sinclair QL World, 
which contained unsolicited quotations from happy Digital 
Precision customers. That collection covered only three programs (and that too only partly - we 
ran out of space) and predated the release of what many consider to be our best software 
(LIGHTNING SE, PERFECTION SE, PROFESSIONAL PUBLISHER, CONQUEROR SE etc). 
We reproduce those pages below, duly reduced to fit. If you want a readable copy, consult the 
relevant back issue or send us an SAE or ask for a full-sized copy while ordering from us... 
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PERFECTION SPECIAL EDITION 





AN EXCITING NEW DEVELOPMENT - Version 5! 


In the case of many word-processing objectives, the best way to 
implement them is pretty clear. There are some areas, however, 
where individual tastes and preferences can differ very widely. 
One such area is the reformatting of text - the adjustment of 
previously entered text to conform to margin, indentation, 
justification and pagination settings after you go back (or 
forward!) to it and make alterations, either by hand (by typing 
and/or deleting) or by using individual or global search and 
replace. When new text is being entered at the foot of the 
document or at the end of the current paragraph, all word- 
processors behave virtually identically, obeying the current 
settings - it is in the matter of amending existing text (inserting, 
changing or deleting) where conflicting philosophies apply. Text- 
handlers differ in their treatment of this: Editor, Wordperfect, 
text87, Quill, AmiPro & Word all behave differently. 


Editor, Spy, most versions of Wordstar, and all technical editors 
leave all reformatting to you. While at first this may seem harsh, 
this manual mode gives you a lot of control, makes the handling of 
tables and other technical applications better (do you really want 
to reformat that BASIC program into a single paragraph?!?), and 
is easy on the eye. But you must remember to reformat as the 
program won't, and this may be an annoyance. If you move away 
and forget to clean up, your printout will probably be incorrect. 


Wordperfect will auto-reformat, but generally only when you 
move the cursor from the line containing the change. Changes you 
make while your cursor is within the line will only cause the line 
to contract or expand up to the margin. This too is easy on the eye, 
but there is the drawback that the overall picture of the page may 
be inaccurate while you are inserting or amending text, and that 
when you move the cursor away (and hence trigger the auto- 
reformat), you may not notice any undesirable effects caused (e.g. 
widows, orphans, inappropriately positioned page or line breaks). 


QL Quill auto-reformats, but because of its slowness it uses a 
trick: often when you start inserting within the middle of a 
paragraph, Quill splits the para in two and creates temporary blank 
lines to separate the parts. This means Quill does not need to 
reformat until you have finished amending. What you type appears 
at the end of the first part of the paragraph. This has the advantage 
and disadvantages of the Wordperfect method, but additionally the 
split can be a bit disconcerting and the screen display can be 
grossly wrong during the editing. Also, we know of a bug that 
causes a line to be shown twice on the Quill screen while it is only 
really present once: you will regret it if you delete the apparent 
duplicate as an unduplicated line will get deleted without warning. 


Word (a fine PC Windows program) auto-reformats in situ, in real 
time, as-you-type. But if you have a long complex para and you 
are editing near the top of it, you may notice the time taken for the 
reformat even on a 486/66MHz (QL users should note that this is 
>20 times faster than a Gold Card i.e. about the speed we expect 
from a fully tweaked QXL). Also, cursor movement will appear to 
some as a bit erratic (which is hard on the eye) especially if right 
justification is on or if the on-screen fonts are proportional. It can 
also be quite distracting to keep seeing the ripple effect of changes 
as text on lower lines is reformatted. AmiPro is somewhat better in 
this respect as there is a small delay (almost a second) before 
AmiPro refreshes lower lines on the screen: easier on the eye. 


The new release of PERFECTION SPECIAL EDITION, version 5, gives 
the user the best of all worlds, by combining the best of all the 
above methods and avoiding all the drawbacks. The user is given 
the opportunity both to pre-configure and to adjust at will from 
inside the program, the desired auto-reformatting behaviour. The 
options are to either select Never (giving Editor-like action for 
technical users: this is what all previous versions did, where you 
had to press a key to get the para to reformat after re-editing it), 
Instant (giving in-situ real-time automatic reformatting as-you- 
type, as does Word) or User-delay, the most flexible setting of all 


(giving slightly delayed updating of lower lines of text, like 
AmiPro, but also - and unlike AmiPro - giving you, the user, full 
control over how long the delay is). No other w.p. is this able. 


On User-delay the user is free to set any delay from 0.1 seconds to 
99.9 seconds in 0.1 second steps. About 1-2 seconds is best for 
slow typists, and 1.5 seconds is thus the default. This means that 
you are not hassled by continuing screen changes on lines below 
the one you are editing and concentrating upon, or shufflings 
around on the current line caused by right justification etc. So the 
Word disadvantage (much more noticeable on slower hardware) is 
avoided, without recourse to the Quill temporary blank line 
nuisance. When you pause in your typing for longer than the set 
delay, PERFECTION SPECIAL EDITION (SE) automatically tidies up, 
without you having to do anything (getting around the 
Wordperfect and Quill drawback of making you mentally adjust 
for the screen remaining occasionally out-of-sync with reality). 


If you are a reasonably fast typist, you can experiment with shorter 
delays (say 0.5 seconds). If you are a speed demon, set the delay to 
0.1 seconds and see if you can ever manage to "get ahead" of the 
program! Settings of under 0.3 seconds are indistinguishable from 
‘Instant’, when reformatting always keeps pace. 


On the User-delay setting PERFECTION SE will, as does Quill and 
Wordperfect, auto-reformat instantly (no matter how long a delay 
you have set) if you either navigate off the line or invoke any 
menu or direct command (including Save, Export etc.). This 
means that you are never left with the document "wrong". 


There are many other improvements in this release of PERFECTION SE. 
One in a similar area is with SHIFT/CAPS, the one (out of five) manual 
reformatting commands that allowed reformatting of a para from the 
current line onwards without affecting previous lines. SHIFT/CAPS will 
now additionally obey the indent margin (which matters if the cursor is on 
the first line of the para) and, more significantly, it will leave the cursor 
position unaltered within the text (previously, it used to move the cursor to 
the start of the next para). Other reformatting commands are unaltered, so 
you can still step through paras reformatting easily. 


PERFECTION SE v5 costs £99.95, or £139.95 in PLUS SE incarnation (i.e. with spellchecker, dictionaries 
& maintenance programs), less discounts that can total 40%. There is no special upgrade price to v5 
for existing SE owners - only DP's usual reasonable £10 update charge (but as an offer to AQLR 
readers, open for four weeks from the date of publication of this issue, existing SE or PLUS SE owners 
can get the upgrade totally free provided they order other DP programs of total value (after all 
discounts) exceeding £25). To upgrade from the STANDARD version of PERFECTION costs, as with 
all upgrades, the difference in price plus just £10, ic. £50. The user should not retum any 
documentation, just the one master disk. Remember special deal prices, which give discounts of up to 
25% if more than one program is purchased (or upgraded) at the same time (do you have 
LIGHTNING SE?). To get the very best out of PERFECTION SE, use it with PROFESSIONAL 
PUBLISHER (and perhaps with attendant TOOLBOXes and FONT ENLARGER), when you can 
output text to any number of shapes of any desired complexity (not just boring columns!) throughout 
maintaining pixel proportional spacing and having thousands of fully WYSIWYG fonts to choose 


from, whatever your printer.... All trademarks are acknowledged as belonging to their respective owners. 


OTHER SPECIAL PROGRAMS FROM DP 


PC CONQUEROR GOLD SPECIAL EDITION The rave review on pages 16 to 19 of 
March 1993 QL World really says it all: "an excellent product", "much faster, more compatible and capable 
than its predecessor". There are many extra features too. You can also get DR-DOS v6.0 (with Netware Lite 
free), which is the best DOS of all. And if you are buying or have bought this DOS from us, you can buy 
preconfigured DOS pseudo hard disks (on ED diskette) for £15 each (specify if you want compressed i.e. 
6Mb capacity, or 3Mb: or have one of each for £25). 

QMATHS MATHEMATICAL SYSTEM PART TWO A superb companion to 


QMATHS, with maths, stats, Abacus stuff, expression evaluation, terrain plotting, the fastest Mandelbrot 
routines and much more. Note the special price for 1+2. 

TRANSFER UTILITY SPECIAL EDITION Copies and transfers, with optional sorting, 
case-changing, formatting, statistics and more. 

QUICKLASER Superb print output from PRO PUBLISHER to HP Deskjets, Laserjets (the latter 
with IMb of RAM or more) and all compatibles. QUICKLASER costs just £19.95 all inclusive. 
LIGHTNING SPECIAL EDITION GOLD CARD VERSION Optimal speed from 
higher specified QLs - GOLD CARD, QXL, ST/QL, Thor XVI etc. Free upgrade from standard version if 
you return ROM + disk and are ordering something else at the same time, else £10 charge. 
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PERFECTION PLUS 


Perfection Is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying Just this... and all of these letters 
were unsolicited. "Superb" was used most often. 


Perfection manages to achieve all the sophistication of 
the most complex PC word processors while still using a 
user Interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are familiarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used interchangeably and even 
simultaneously. Even more exciting — both systems are 
iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, it is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already 'within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes it very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even if speed is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Spelichecking, assuming you have Perfection Plus, 
is accomplished virtually Instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another is usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read in Quill doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export is also possible. 


Perfection Is truly WYSIWYG: this means that bold 
appears bold on screen, Italics appear as italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as welll 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are in Insert or Overwrite mode, whether a block Is 
defined, whether Interactive spelichecking is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another. The sizes of the two windows are themselves 
adjustable, both In real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, if you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There Is absolutely no way that we can prepare you for 
the quality ‘feel’ of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So If you thought Perfection was unattainable, you have 
a very pleasant surprise coming to you! 


These programs accelerate QL operation by up to 10x (2x 
—4x Is typical) without having any adverse effect 
whatsoever on compatibility or anything else. Lightning 
SE is typically 40% faster than the standard version. This 
acceleration is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So if you 
have Gold Card, your need for Lightning SE is just the 
same as if you had only an unexpanded QL - Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 
automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once installed, Lightning can be completely 
forgotten about — you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology Is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: if you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The Professional in Professional Publisher is 
Professional Publisher supplied with a generous 
refers to the quality of selection of fonts of vari- 
output from that program, ous sizes, as well as clip 
and is not meant to sug- 
gest any complexity of op- 


eration. Few programs are 
as easy to use as this 
one: e 
99% KG ak 
users will \\ 
be able ae "oO 
to do , 
with- O 

out using 
a manual! 
Professional Publisher is by 
far the best DTP program 
for the QL. It Is fully com- 
patible with Perfection, 
Editor, Quill, Eye-Q & the 
ASCII editors. It allows you 
to both create and import 
both text and graphics. 
Text can be ‘poured’ into 
boxes of any shape , size 
and number, automatically 
maintaining Justification 
and hyphenation settings. 
So flowing text around 
graphics is a doddle. 


gor” art. 


ogi Justification 


is by pixel, not by 

character. This gives a 
much smoother effect. 
It is pointless for us to try 
to list all of Professional 
Publisher's features —- we 
would end up filling half 
the magazine! We will 
concentrate on just a few 
‘points': Professional 
Publisher is extremely pre- 
cise, performing all its 
computations accurate to 
a small fraction of a mil- 
limetre. All its features can 
be preset by you using its 
configurator, ruling out 
the need for repetitive key 
strokes. 
The program |: extraordi- 
narily versatiie while re- 
maining Intuitive in Its 
user interface. Buy it! 





PROFESSIONAL PUBLISHER 
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Toolbox | is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 
a wider range of typefaces and styles. 


Toolbox Il starts where Toolbox | leaves off, providing an 
even better — and different — font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 





FONT ENLARGER 


GRAFIX 


Font Enlarger does exactly what you would expect it to 
from its name. While Professional Publisher Is also 
capable of enlarging fonts, it does them ‘on the fly’ and 
consequently is not able to remove the jJaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 





While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, it is not optimal 
with 24-pin or laser printers. Grafix is. 
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Eye-Q Is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even if you aren't). Eye-Q graphics can be read In 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox |). Everything in Eye-Q 
is menu-driven and there is context-sensitive help. 


While Eye-Q has Its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning Is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 


PC CONQUEROR 
SOLUTION 


PC Conqueror makes your QL Into a PC-compatible 
machine,automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 
Alternatively, you may wish to tap into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk In floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC - this means putting a DOS disk (any 
version) into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it is possible for a PC 
emulator to run: we have used all our skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
If you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card. This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 


SPELLCHECKER 
MEGA DICTIONARY 


Spelichecke” is what makes Perfection into Perfection 
Plus. We have made it available as a separate item for two 
reasons: (a) to allow Perfection owners to add It later 
(b) to allow users of other word processors to benefit 
from the very best in spelichecking technology. 


Spelichecker is supplied complete with three dictionaries 
of differing sizes as well as a system for buliding, 
reviewing and maintaining user dictionaries. 


Spelichecker's ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 





3D PRECISION CAD SYSTEM 





This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your interest is in CAD, 
in animation or In Just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 
















MEDIA MANAGER SPECIAL EDITION 
MEDIA MANAGER 


Media Manager Special Edition (MMSE) is a program to 
be used both when things have gone wrong as well as 
when things are perfectly OK. it allows for automatic, 
semi-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE Is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 


MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager is both less powerful and 
less user-friendly, but manages to work on an 
unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer is at file and directory level, 
Is bi-directional and is completely automatic. 


SPECIAL DESKTOP PUBLISHER 
DESKTOP PUBLISHER 


These programs are quite primitive compared to 
Professional Publisher. However, if you have not 
experienced that program as yet, you will find both of 
these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
is able to run on smaller systems. 


EDITOR SPECIAL EDITION 





THE EDITOR 


With the sole exception of Perfection, this is the best 
word handling system on the QL. Editor's features 
Include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 
break displays. Neither program Is suitable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the Ideal combination Is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


PROFESSIONAL ASTROLOGER 
PROFESSIONAL ASTRONOMER 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe in 
astrology — indeed, especially if you do not — this 
program Is one that you cannot afford to have. You can 
tailor the readouts (both in terms of quantity and what 
is said) to your own particular requirements. The amount 
of fun you can have with this program is endless. Do not 
blame us if you start believing in astrology, though! 


Astronomer is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 


TURBO BASIC COMPILER 


Turbo is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 


Turbo automatically converts working BASIC programs 
into optimised machine code, usually with no need for 
human intervention. The benefits of this conversion are 
vastly enhanced running speed (as well as much faster 
loading, encryption and automatic bug fixing for a variety 
of QL interpreter oddities). Typical speed-up Is 40x — 100x. 


Turbo {fs provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he is a novice or an expert. There are commands 
to load strings and floats into RAM, and to extract them 
automatically; to search memory and to move its contents; 
to control Jobs and change their priorities, manage pipes, 
allocate and deallocate memory, to contro! both rubber 
and virtual arrays, to present INPUT with-an editable 
default, to have random access to files and much more. 





TOOLKIT fll 


Toolkit lll starts where Toolkit ll stopped, adding about 
60 new commands and enhancing many existing dual 
functions. Toolkit Ill Is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit Ill commands can, with only a couple of 
exceptions, be compiled using Turbo. 


QFLICK CARD INDEX 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive Is competent, it is very hard to get 
to grips with and is not particularly fast. QFlick presents 
a very convenient alternative — a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between OFlick and Archive in either direction. 


OFlick Is not itself programmable but we document Its 
data structure and give guidance on how to program it 
using Turbo. 


ARCHDEV + RTM 
DATABASE ANALYSER 
ARCHIVE TUTORIAL 
NAMES + ADDRESSES 
MAILMERGE 
DAT-APPOINT 
SEDIT 
SCREENPRINT 
RECOVER 


This suite of utilities will greatly enhance your use of the 
Archive database system. 


Archdev + RTM Is a straight replacement for Archive: it 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 


Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 


Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 





Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, mallmerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 


SEdit allows you to create and edit screen format files In 
Archive. Screenprint allows you to print them out. 


Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 


XREF 
SUPERBASIC MONITOR 
BETTERBASIC EXPERT SYSTEM 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 


SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. 


BetterBasic analyses and automatically corrects structural 
flaws in your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 


The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


TRANSFER UTILITY 


This program copies files at high speed between devices, 
performing translates as it goes along. Ideal for all sorts of 
applications, including transfers from microdrive to disk. 





QMATHS SYSTEM 


This is an incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one . 
into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, inverse functions, infinite series Including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourier series, and lots of calculus: both 
differential and integral, induding integration by parts 
and definite integrals. QMaths optionally displays its 
workings and comes with a superb interactive tutorial. 


The package also contains an interpretive, fractal, image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill is required. 


There Is also a multiple predsion floating point maths 
package, giving calculations at precisions up to over 600 
decimal digits of accuracy. 


There Is even more to this system, but we think we have 
told you enough. 


QMON MACHINE CODE MONITOR 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
Is going on In the QL. No other machine code monitor 
even comes close. 


Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


COMPARE 


This program compares files - data or program - at 
colossal speed. Where a mismatch is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. 












CASH TRADER WITH ANALYSER 





PAYROLL 


Cash trader with Analyser Is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, It has excellent reporting and 
management facilities, and is very flexible. it is almed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect — Including audit trall - are present. 


Payroll is a reasonably flexible system designed to 
automate the payroll function in smail businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


HARDBACK WITH FINDER 


This is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue is via overlapping pop-up windows - 
the whole program Just feels right. It Is possible to scan 
the disk at great speed, too. 


PIM) Gpele] Raina mreleile ¢p) hy. 4 


This permits you to add password protection to disks, to 
optionally increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%. All this is done while maintaining full compatibility. 
Automatic file management is also provided. 














DIGITAL C SPECIAL EDITION 
DIGITAL C 


These are extremely fast and efficient C compilers, 


complying with and len A the Small C definition. 
u 


The Special Edition goes much further, including support 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 


SPECIAL DEALS 


5% off total if you buy 2 programs/upgrades; 


10% off 3; 15% off 4; 20% off 5; 25% off 6+ 
Upgrades cost difference in price + £10 
Non-UK Europe add 5%, rest of world 10% 


For full terms ond conditions, please refer to any of our QL World ads from Jan—-Nov 1990, or write in including a SAE 


CPORT IMPROVED VERSION 


A brand new CPORT system, enabling you to rapidly 
convert your SuperBASIC programs into C (ANSI or 
Lattice). The new (October 1992) version is now as 
close to being fully automatic as makes no difference 
— you must get it! 


Owners of our earlier CPORT versions should return disk + SAE for a free upgrade. 


SUPERFORTH COMPILER WITH REVERSI 


Forth is the most logical computer language. This compiler produces multitasking code. 
The manual teaches you Forth-83 from scratch. 


IDIS SPECIAL EDITION 
IDIS 


These Intelligent disassemblers make the otherwise terrifyingly complex task of 
understanding other people's machine code programs absurdly easy. The SE version, 
which has a higher hardware requirement, sorts out some routines, replaces addresses 
with names, untangles data from code and much more. 


-QKICK FRONT END SYSTEM 


This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick 
runs In the background and can be called up at any time. It provides you with notepads, 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 
mini-database and so on. 





























ADVENTURE CREATION TOOL SPECIAL EDITION 


ACT is a must for every programmer. The name of the program is misleading, insofar as it 
has capabilities far beyond the ‘mere’ creation of adventures. ACT has utilities providing 
animated graphics, data compression, language design, parsing, maps, object-oriented 
control etc. If all you want to do Is generate adventures, though, you do not need to be 
a programmer to use it. This Is a purchase you will never regret. 


PEDIT 


A fast, modern and capable printer driver for the programs bundied with the QL. 


MICROBRIDGE 


Superb contract bridge bidder (ACOL etc) and player, using millions of random but 
reconstructable hands. Microbridge also includes a state of the art Interactive bidding 
tutor and a clear Instruction manual. There is nothing like this anywhere else! 


SUPER ASTROLOGER 


A very cut-down version of Professional Astrologer — still great fun, though! 


SUCCESS CP/M EMULATOR 


Allows your QL to run CP/M programs at great speed. 
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Signed: 


3-D PRECISION CAD SYSTEM 49.95 
ADVENTURE CREATION TOOL SPECIAL EDITION 49.95 
ARCADIA GAME | 9.95 
ARCHIVE DEVELOPMENT SYS + RUN-TIME.MODULE 29.95 
ARCHIVE TUTORIAL 19.95 
BETTER BASIC EXPERT SYSTEM 24.95 
BLOCKLANDS GAME 9.95 
CASH TRADER v3.3 + ANALYSER 99.95 
COMPARE FILE UTILITY 19.95 
COPY UTILITY FOR BACKING UP 9.95 
CPORT BASIC TO C TRANSLATOR WITH C68K COMPILER 99.95 
CPORT BASIC TO C TRANSLATOR 89.95 
DATABASE ANALYSER FOR ARCHIVE 19.95 
DAT-APPOINT APPOINTMENT DATABASE SYSTEM 19.95 
DESKJET/LASERJET DRIVER FOR PRO PUBLISHER 19.95 
DESKTOP PUBLISHER SPECIAL EDITION 39.95 
DESKTOP PUBLISHER 24.95 
DIGITAL C COMPILER 29.95 
DIGITAL C SPECIAL EDITION 49.95 
DISKTOOL WITH QUICKDISK 19.95 
DROIDZONE GAME 9.95 
DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 79.95 
EDITOR SPECIAL EDITION 49.95 
EDITOR 29.95 
EYE-Q GRAPHICS SYSTEM 39.95 
FONT ENLARGER 19.95 
GAMES COMPENDIUM (ALL FIVE GAMES) 29.95 
GRAFIX 24-PIN UNIVERSAL. PRINTER DRIVER 14.95 
HARDBACK + FINDER HARD DISK MANAGER 49.95 
IDIS INTELLIGENT DISASSEMBLER 24.95 
IDIS SPECIAL EDITION 39.95 
LIGHTNING ACCELERATOR 24.95 
LIGHINING SPECIAL EDITION ACCELERATOR 49.95 
LIGHINING SPECIAL EDITION FOR GOLD CARD 39.95 
MAILMERGE DATABASE SYSTEM 19.95 
MEDIA MANAGER SPECIAL EDITION 49.95 
MEDIA MANAGER 24.95 
MEGA DICTIONARY 29.95 
MICROBRIDGE 39.95 
NAMES AND ADDRESSES DATABASE SYSTEM 19.95 
PAYROLL SYSTEM 49.95 
PC R GOLD SPECIAL EDITION WITH DR-DOS v6.0 179.95 
PC R GOLD SPECIAL EDITION 99.95 
PC CONQUEROR WITH DR-DOS v6.0 139.95 
PC R 59.95 
PEDIT PRINTER DRIVER FOR XCHANGE 19.95 
PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 139.95 
PERFECTION PLUS WITH SPELLCHECKER 99.95 
PERFECTION SPECIAL EDITION WORD PROCESSOR 99.95 
PERFECTION WORD PROCESSOR 59.95 
PERFECT POINTER TOOLS 29.95 
PROFESSIONAL ASTROLOGER WITH ASTRONOMER 69.95 
PROFESSIONAL ASTROLOGER 59.95 
PROFESSIONAL ASTRONOMER 29.95 
PROFESSIONAL PUBLISHER TOOLBOXES (PARTS ONE & TWO) 49.95 
PROFESSIONAL PUBLISHER TOOLBOX PART ONE 29.95 
PROFESSIONAL PUBLISHER TOOLBOX PART TWO 29.95 
PROFESSIONAL PUBLISHER 89.95 
FLICK CARD INDEX SYSTEM 29.95 
ICK FRONT END SYSTEM 24.95 
THS MATHEMATICAL SYSTEM PART ONE 69.95 
THS MATHEMATICAL SYSTEM PART TWO 59.95 
THS MATHEMATICAL SYSTEM (PARTS ONE & TWO) 99.95 
MACHINE CODE MONITOR v2.05 39.95 

VER ARCHIVE UTILITY 19.95 
REVERSI GAME 9.95 
SEDIT + SCREENPRINT ARCHIVE UTILITIES 39.95 
SOLUTION PC EMULATOR WITH DR-DOS v6.0 109.95 
SOLUTION PC EMULATO 29.95 
SPELLCHECKER WITH. DICTIONARIES 49.95 
SUCCESS CP/M EMULATOR 49.95 
SUPERBASIC MONITOR 24.95 
SUPERFORTH COMPILER WITH REVERSI 39.95 
SUPER ASTROLOGER 24.95 
SUPER BACKGAMMON GAME 9.95 
SUPER SPRITE GENERATOR 29.95 
TOOLKIT III WITH ROW 49.95 
TOOLKIT III 29.95 
TRANSFER UTILITY SPECIAL EDITION 29:95 
TRANSFER UTILITY 9.95 
TURBO BASIC COMPILER + TOOLKIT 79.95 
ULTRAPRINT SCREEN DUMP UTILITY 19.95 
IC PROGRAM ANALYSER 29.95 


XREF SUPERBAS 
KEY>>>>>)» Available either on cartridge or disk 
Available only on disk 


Minimum 512K exp:only available on disk 
Minimum 256K exp:either cartridge or disk 
Minimum 256K exp:only available on disk 


Available only on cartridge 


Encl: CHEQUE/VISA/ACCESS/MASTERCARD/PO/MO/CASH for € .............. 


POUR UT CUS SUISSE Ss) 


Minimum 1.5Mb RAM: only available on disk 
As well as cartridge or disk, you get a ROM 


Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 


OO eee ee OER OO ROO ROS OOO E SO EEE EEE EEE ESS SES OE SED EES EES OER OES SES ROO HES SEE EOE CES ETSSEOEES EES OES EEE SEDESEESOUSE SPO COS SEE SHS SES SEE ESE SES SEE SEE SEE SES SOSOSSSSH TIS TOS HOUSES EOS SSO SSE ESHSES SES ESSSESSES HES OHH OST HOSHSS SES ESSLHSSLHSSHLI OEE 


PTY UTERTTETEETELULELIOLETI EL TT 


Postcode: 





WSR 


O dear! Bryan Davies loses ££ searching for préof of a perfect character. 


Text87 Plus-4 version 4 
has been tested with the 
QXL card and works at 
screen resolutions up to 800 
x 600 pixels. On the Atari, it 
has been tested at up to 
1000 x 1000 pixels. The 
higher resolution allows 
more than one page to be 
displayed at a time. 
However, the effect is not yet 
as good as one would wish, 


because the image does 


not fill the screen. 


Linedesign 


Linedesign 2 is being 
tested, and should contain 
some welcome improve- 
ments. In particular, it 
redraws screen images a lot 
faster. This applies to both 
text as well, as this is dis- 
played graphically too. In the 
past, text has usually been 
stored in “library” form (not 
by Linedesign, though) with 
each character pre-defined 
in shape and size. This has 
meant having individual files 
for each size, creating a 
mass of files which take up 
much disk space. The 
advantage of this method is 
that it is fast; you don't nor- 
mally think about the char- 
acters being displayed on 
the screen when you type in 
Quill, because they appear 
more or less as you type. 

Text in Linedesign 1 is a 
purely graphical affair, the 
founts being stored as sets 
of instructions for displaying 
the characters, rather than 
as pre-drawn characters. 
While this avoids masses of 
fount files, it results in slower 
text display, as each charac- 
ter is constructed, section by 


section, on the screen. It is 
rather like a pavement artist, 
sketching a likeness of a 
passer-by. One option for 
Progs, the writers. of 
Linedesign, is to switch to 
displaying text in bit- 
mapped form, using a few 
fixed sizes. Alternatively, they 
could simplify the design of 
screen founts, so that fewer 
calculations are needed to 
draw them. The same founts 
are (presumably) used for 
both screen display and 
printing, and any changes 
will affect what appears on 
the printed page. Programs 
on other computers often 
use different sets of founts 
for the screen and printer, to 
get around the problem of 
slow screen display. Printing 
is normally a secondary 
activity and users will put up 
with slowness there, espe- 
cially if buffering is available 
to make printing a back- 
ground job. 


WYS/IWYGuess 


By now, many users will 
have realised that the WYSI- 
WYG (what you see is what 
you get) we all wanted from 
wordprocessors is not quite 
what we hoped. Text87 gets 
around the display problem, 
to some extent, by providing 
a set of fixed screen founts. 
The user has to match these 
to printer founts as best pos- 
sible; in some cases, they 
will look acceptable, but the 
Small range of screen founts 
and sizes limits the WYSI- 
WYG effect. Perfection 
approaches the problem in 
another way, representing 
different founts by variations 
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of the display colours, both 
foreground and background. 
The Fountext graphical dri- 
ver for Text87 gives an actu- 
al WYSIWYG effect, except 
that the size of screen text 
differs from that of printed 
text. The characters on the 
screen are considerably 
larger than what appears on 
paper, making it necessary 
to choose sizes which are 
nominally much above what 
you want printed. One con- 
sequence of the larger dis- 
play size is a limited amount 
of text visible on the screen. 
This may not be a great 
hardship for the user, and 
display is not noticeably 
slow. From the users point 
of view, utilising exactly the 
same founts for screen and 
orinter seems to be the way 
to go, and - by all accounts - 
the screen display on the 
obvious “micro” that does 
this (the NeXT) is impressive. 

On other micros, the soft- 
ware writers have relied 
upon the hardware design- 
ers to get them out of the 
hole they have dug for 
themselves with WYSIWYG. 
Faster processors have cov- 
ered up the slowness of cur- 
rent wordprocessors, but 
only for those fortunate 
enough to afford faster hard- 
ware. To a large extent, this 
has meant that wordproces- 
sors run really well only on 
systems installed in compa- 
nies where money is no 
object. The Gold Card has 
provided a considerable 
boost in speed, which has 
made some old programs - 
notably Quill - look a lot bet- 
ter than they used to do. 
However, we are favoured 
with two word processing 


programs which are actually 
considerably faster, in most 
respects, than Quill. They 
achieve this by working in 
normal text mode, though, 
and it remains to be seen 
whether they will develop to 
display text that looks as 
orinted, and whether they 
will then still be fast. 


Fountext 


The Fountext driver does 
give the desirable likeness 
between screen and paper, 
but it is limited by a fixed set 
of founts and sizes. There 
are no scalable founts (ones 
which can be used at 
almost any size). The founts 
supplied are not vector 
drawn ones and do show 
some jaggedness, even with 
a laser printer. The printer 
type supported is a 24-pin 
dot matrix; while some of 
these give surprisingly good 
print, it is not comparable 
with laser quality. 

One big merit of 
Linedesign is that the range 
of sizes for text is virtually 
unlimited. In “real life” word 
processing, It is common for 
a range of sizes to be 
required for one fount - Say, 
Helvetica 8-, 9-, 10-, 11- and 
12-point The bulk of the text 
may be in 10-point, with 
headings and sub-headings 
in 12- and 11-point. The 
smaller sizes are used for 
text which has lesser impor- 
tance, such as footnotes, 
headers and footers. 


Wet Ink 


Ink-jet printers have 
brought the cost of good- 


quality printing down. They 
can be messy, but are usu- 
ally no worse than dot-matrix 
printers. Anyone who has 
not considered the cost of 
running ink-jet printers 
would do-well to do so, 
though. They are not cheap 
to run. A rough calculation 
for the Canon BJ-10 
BubbleJet suggests that 
replacement ink cartridges 
cost roughly 2-3 times the 
‘my laser print toner car- 
tridges for the same number 
of printed sheets. The car- 
tridges cost about the same, 
but seem to do a lot less 
sheets in the bubblejet. - 

One way of keeping cost 
down is to refill the ink car- 
tridges. The procedure for 
doing this can be straightfor- 
ward, provided you take a 
few precautions. The cost of 
ink refills is roughly half that 
of cartridges, but one suppli- 
er at least charges less (£6 
plus VAT). There is always a 
risk when doing something 
like this during the guaran- 
tee period or a printer; the 
manufacturer and/or suppli- 
er might refuse to honour 
the warranty. This should not 
happen with ink-jet printers, 
because the cartridge is self- 
contained and the quality of 
the ink will normally not 
affect other parts of the 
mechanism. But do check 
your company literature 
carefully. | | 

The first rule would seem 
to be not to let the cartridge 
nozzles dry up. There are 64 
nozzles in the small print 
head of the bubblejet car- 
tridge. Do not leave the print- 
er unused for long periods, 
and refill cartridges as soon 
as they run out. If your printer 
has a self-clean function, 
use it often. You can clean 
cartridges out, but what is 
best to use | do not know. 
lsopropyl alcohol seems sat- 
isfactory, as it is a solvent 
but evaporates fairly quickly; 
it is used in the ink in origi- 
nal cartridges, so should not 
be harmful to them. As for 
washing with water - has 
anyone tried this often 
enough to know whether it 
is effective and safe? 


If you have suitable ink, 
there is no obvious reason 
why you should not use 
colours, in both inkjet (that is, 
Hewlett-Packard DeskJet 
and similar) and bubblejet 
(Canon Bu and offspring). 
Roy Barber, former Quanta 
editor, uses ordinary Quink 
fountain pen ink and is sat- 
isfied with it It does not dry 
out in as endorsing pad ink 
and ethers do. Advice from 
Alf Kendall is not to invest in 
bottles of “special” refill ink, 
not because the ink is not 
Suitable, but simply because 
it may outlive your printer - 
the bubblejet cartridge con- 
tains roughly 10 millilitres. 
Work out how many refills 
you would need to finish a 1 
litre bottle! Be sure to cover 
the filler hole after refilling, as 
you may tip the printer up at 
some later date with messy 
consequences. 


Readers’ 
Letters 


Ken Attwood asks for 
advice on saving moderate- 
ly long Quill documents. He 
has a document of 23 
pages, but there are only 
5000 words in it, and the 
lines are double-spaced. He 
does not say how large the 
file is, in terms of disk space, 
but it should take no more 
than 50-100 KB. The save 
operation fails with the mes- 
sage ‘I/O incomplete’, and 
the original copy of the file is 
wiped from the disk. 

One thing Ken does not 
say iS what version of Quill 
he is using, and that is 
important. Earlier versions 
gave trouble saving longer 
documents, whereas the 
‘final’ version, 2.35, was quite 
good in this respect. In my 
own tests, It would work with 


files up to about 600 KB - far 


bigger than Ken's file and it 
fell over then for some rea- 
son other than the usual 
one (judging by the way it 
went). 

So that is the first thought: 
if he is using 2.30 or earlier, 
he should get 2.35. Having 
said that, my recollection is 


that 2.30 was really not bad, 
but anything prior to that is 
suspect (in more than one 
respect), 

It apparently makes no dif- 
ference what drive is being 
used - floppy, hard disk, or 
ram. His final comment is 
worth repeating: “| hope the 
problem can be overcome 
as | like Quill and prefer its 
simplicity...(to) Winword that | 
am..forced to use at work’, 


“Obvious?” 


You cannot afford to 
ignore the “obvious” possi- 
bilities with such problems, 
because they are not always 
obvious to everybody. When 
Quill was written, memory 
was scarce; the QL had a 
total of 128 KB, of which 32 
KB went for screen use 
straight away. Of the remain- 
ing 96 KB, Quill needs most, 
and you have maybe 20-30 
KB for your work. Squeeze 
Quill by giving it only 60-70 
KB to load into, and it is like- 
ly to express its disapproval 
by overflowing back onto 
disk. The famous file 
DEF_TMP is not created 
solely for holding the text of 
your document; it can be 
created simply by loading 
the program, if memory is 
short. 

Assuming Quill is loading 
without overflowing, is the 
actual text file is overflowing 
to disk? Ken has a Gold 
Card, so lack of memory 
should not be his problem. 
He may be using other pro- 
grams at the same time; if 
they are loaded before Quill, 
there might be a shortage of 
memory by the time his doc- 
ument is loaded, but this 
seems unlikely. As people 
have found, when Quill is 
loaded first, nothing else 
gets a look in, because Quill 
grabs almost every byte of 
available memory. If his sys- 
tem has about 100 KB of 
free memory, at the time of 
loading his document, it 
should fit without overflow. 

In the situation where doc- 
ument overflow occurs, disk 
space can be a factor. The 
temporary overflow file will 


take up aS much space as 
the saved document. That is, 
the maximum size of docu- 
ment you can work with, in 
the overflow situation, is 
about half the free space on 
the disk, so a 100 KB docu- 
ment needs something over 
200 KB disk space. Should 
the free space on the disk 
drop near zero, and the on- 
screen document be 
increased in size, saving is 
clearly impossible. 

One way of increasing the 
maximum file size you can 
work with is to load the doc- 
ument file from flp1; the tem- 
porary overflow file will go to 
flo2, allowing a theoretical 
maximum file size of near to 
the full capacity of a disk. 
This is hardly likely to help 
Ken, though, as his docu- 
ment is too small to need 
such measures, 


Lost... 


Possibly the oldest “chest- 
nut’ in the micro printing 
world is the missing £ sign. 
How many users have never 
had to figure out why the 
character printed bears no 
resemblance to the on- 
screen sign, or even why the 
screen character is different 
from the key pressed. To the 
computer novice, this is a 
big fiddle but, once you 
have spent a few years 
learning the tricks, it is easily 
dealt with. So why do we 
see the wrong character in 
magazines too? This com- 
ment applies mainly to ama- 
teur newsletters, but the 
glossies are not above it. 
surely it's not all that difficult 
to print the UK currency 
symbol? (This is the only 
sign people have trouble 
with over a period of years. It 
stems, or course, from the 
fact that UK and USA soft- 
ware and hardware arrange 
their currency signs different- 
ly, and if any one item in the 
chain - computer, software, 
printer, and any other com- 
plications like a daisywheel - 
is different the £ sign will flip 
into something — else. 
Incidentally, why does your 
computer never give mine a 
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£ sign when everyone else's 
does?? Ed) 

Another facet of the prob- 
lem is the failure to print so- 
called “foreign” characters 
properly. One of our 
Norwegian readers has 
taken a bashing recently, 
with his name spelt wrongly 
in both QL World and 
Quanta. The problem is 
two-fold: the difficulty of 
transferring these accented 
letters between programs 
and computers, and possi- 
bly the lack of adequate 
prddf reading just before the 
text goes to press. Maybe 
the errors are spotted but 
nothing is done about them. 
(We've replaced all your “| 
signs with £ signs, Bryan. 
Count'em,) 

With the £ sign, we have a 
difficulty with the QL, 
because the internal charac- 
ter code is decimal 96, 
whereas the usual code is 
156. The 156 is used in the 
IBM PC Extended Character 
Set, which is effectively the 


standard on the PC. You 
may come across others, 
though; in the ANSI set, the 
£ is 163. The spreading 
monster Windows uses the 
ANSI set, creating two major 
groups of programs with dif- 
fering character codes. A 
quick check through the var- 
ious lists of codes handy on 
my shelf showed other pos- 
sibilities - 11, 61 - although 
these come in special sets 
which replace the standard 
set, not extend it. 


Making a Hash 


The confusion is 
increased by the _ inter- 
change of £ and #. The # is 
USA pound weight (eg 20#) 
or number (#1) symbol. 
Many people buy imported 
computers or keyboards, 
and these normally have the 
# on the 3 key. The code is 
35. A UK keyboard has £ 
with the 3, so it is not sur- 
prising that the £ often gets 


TF SERVICES 


MINERVA 


The ULTIMATE operating systcm upgrade 


MKII MINERVA with battery for 256 
CRASHPROOF clock & Philips RC b ar for interfacing 
Tan autoboot from battcry backed k 2 


Oth 
DEBUGGED operating system/ autoboot Teset/ 
Multiple Basic/ faster scheduler-graphics ( (10% of 
lighting)- os handling/y WHEN a man screen/ 
TRACE/ forcign keyboard driv *warm’ fast reset/ 
Auto reboot after power failure. Vi97 now with built in 
Multibasic and split OUTPUT baud rates with Hermes. 


Ist upgrade: free. Otherwise £3 (+ £5 for manual if requd) 
(send sae, Mmerva & NEW disk/3 mdvs) 
MKI to MKII upgrade - £30 


MKI....£40 MKII.....£65 


GOLD CARD (v2.24+) COMPATIBLE 


0) FENY 2434 ohn 


Power supply 
SSOITILA .hicscoossdhdhovend £10 


Other components/(sockets etc) please phone 


QL REPAIRS 


Fixed price for unmodified QLs, excluding microdrives. 
QLs tested with Thom-EMI rig and ROM software 


£27 including 6 month guarantee 


HERMES 


A replacement QL co-processor for 
the QLs awful IPC 8049 


- Do you get keyboard bounce? 
- Do you find fast serial imput unreliable? 
- Do you want to connect a modem at 19200bps 


If you can say YES to any of these, 
then you need HERMES 


- 19200bps RELIABLE serial input - NO QCONNECT. 


baud rates - use serial mouse & print 


- Provides extra input/output lines 
- Key click 


Fitting is simple. Remove the QL top (8 screws) & 
replace the chip marked 8049 or 8749 next to mdv 1. 


£25 including manual/software 


Oe tiitaurlecs 


The F2C bus was designed by Philips to simplify 
interfacmg. Minerva MKII clock is driven by an PC 
chip, & a connector allows connection of other circuits. 
Our external circuits will interconnect without leads. Up 
to 5 interfaces can be powered off the QL. 


Parallel Interface Each gives 16 input/output ports. 
Can be used wherever logic level signals are required - 
ég model train controllers. Can input directly to motor 
drivers (eg L293/298). 


Analogue Interface Each gives 8 analogue to digital 
inputs, and 2 digital/analogue outputs. 


Data sheets. (analogue/parallel [2C chips) 
Control software/manual (Superbasic extns)......£2 


(First interface purchase inchides free 15D/9D lead) 


Prices include post & packing (UK only). Payment by Mastercard/Visa/Access/Burocard/cheque/postal order/PO 
Giro transfer (58 267 3909). MAIL ORDER ONLY - no callers without rimging first. Ring for overseas prices. 


Holly Corner. Priory Road, ASCOT, Berks, SLS 8RL 


Tel: 0344-890986 


ax & modem: 0344-890987 





¢ : 


tied to the 35 code. The QL 
keyboard tries a “double- 
mix” - the # in the USA posi- 
tion, with the code 35, and £ 
on the key normally occu- 
pied by the # on UK PCs, 
but it has the code 96 rather 


INFORMATION 


Inkjet and bubblejet refill 
ink, £6 (black) and £8 
(colour) plus VAT: 
Concita Micro Systems 


than 156! You have to take Ltd. 

the Character Set and Keys Unit 12 

section of the QL User Stirling Industrial Centre 
Guide with a pinch of salt Stining Way 

when looking for codes, as Borehamwood 

there are several errors in Herts WD6 2BT. 


Tel. 081 905 1707 
Fax 081 207 5822 


some versions of it. 
Returning to Our 

Norwegian reader, Arvid 
Bérretzen. His 'o" should 
have a slash through it You 
can obtain a suitable display 
of the lower case form of 
this character by typing Ctrl- 
Shift-7, and a passable one 
from Ctrl-Shift-r, the second 
form has the slash rather too 
upright, however. But you 
are unlikely to get the same 
character from the printer, 
unless you use the Translate 
function (Quill) or equivalent, 
to send a code such as 
decimal 149 to the printer. 


reorssssae = (EEG) ~=—W VV. Aeichardson & Co. 
SINCLAIR QL PRICE LIST Pure croc 





All Prices Include 17.5% VAT 


|QL Computers} NEW MONITOR £50 CHEAPER 


JS COMPLETE Computer, PSU, T.V. Lead, PSION V2.35 Software Processor, i 

SOE Databaselde Basinnes Ganglia” Fascha he Ot Peat e ater, JO SLL0 
Fes ons years manbeatip w QUANTA, independ QL Ue 
ee ee WARRANTY. 





Oba PeU'enly. 38020 TME6S Punt eccklige ibeante O37 ebtacs 


E 





ess i NOTE: EXTERNAL (SER2) 3 BUTTON MOUSE AND SOFTWARE ke 
Acc orics * WITH EXTRA FUNCTIONS. NOS HERMES COMPATIBLE, 
PC KEYBOARD INTERFACE, INTERNAL FITTING, POR FITTING 102 KEY KEYBOARD £ 75.00 
PC KEYBOARD, UK vession, 102 key (AT) 2 30.00 
PC KEYBOARD INTERFACE and KEYBOARD Nene FREE JOYSTICK OR PSU) & 95.00 
CASE and LEAD for EXTERNAL FITTING of Keyboard Interface £ 14.00 
JOYSTICK with QL lead (no interface required) £ 10.00 
* OL MOUSE, 3 Button, Software controlled, externally mounted, simply fits in SER2 £45 CORDLESS MOUSE € 55.00 
THE UNIVERSAL DRIVES ARE ALSO SUITABLE FOR ACORN BBC, ATARI ST 
Disk Drives }| AMIGA, SPECTRUMS, IBM. AMSTRAD AND OTHER PC COMPATTAILS 
Universal 3.5" 1Mb disk drive, cased with PSU and free QL lead £ 70.00 2 Units for dual drive £120.00 
Universal 3.5” 2Mb disk drive, as above but 2Mh capacity £ 90.00 2 Units for dual drive £170.00 
3.5” IMb Uncased disk drive 2 25.00 
3.5" 2Mb Uncased disk 


drive £ 49.00 
for uncased disk drives, or other universal micros £10.00 POWER SUPPLY FOR UNCASED DRIVES © 6.00 


‘AL CASES FOR UNCASED DRIVES & 6.00 





| Parallel Printers WwW GE 
SAMSUNG SP093 80 300 50 Feed/Sheet 49, 
OLIVET COLOUR PRINTER. 24 200 ep, 50 LO, 46 Baller, Espen LOLSSOIEM Campatiio, £259.00 
QL LEAD FOR SBRIAL PRINTERS £10 CANNON BJ10 EX 
oo 

WITH AMBER OR GREEN TEXT FBATURE, IDEAL FOR WORD 


PROCESSING, RECONDITIONED, 90 DAY WARRANTY 
OK FOR PC AND QL SELF SENSING AND MANY EXT/L CONTROLS 


waa erie) See £39 
2° GREEN SCREEN. 


PHILIPS 14” HIGH RES COLOUR EGA 31 Ste gt | 


Cartridges in a wallet 2 10.00 8 prog casts for sefosmatting in 2 wallets rey 
°: oe beastie ee lncluding 20 new cartridges ; 
QL Psion Software V2.35 Includes Quill, Abacus, Archive, and Easel IN WALLET © 1800 
QL Psion Software programs £ 10.00 
QL power Supply Unit . 10.00 Membrane (and instructions) 2 9.00 
TV or Network leads £ 3.00 BE ale 7 gaa £ 5.00 
IC's eee : <> ZX 8302 £ 3.00 8049 (IPC) £& 3.00 MC 1377 & 3.00 
QL SERVICE MANUALS & y & CIRCUIT. £25.00 ci" aaa 





PEER Payment farms: Delivery: 
= CWO, Access, VISA et cetera Carriage - £9 
Bhar, - allow — Postage « £5 





Product to availability, E& 
1eL * 0753 BBE866 FAX: 0753 887149 


New Files for Old 
Families!! 


Chris Boutal’s popular Genealogy program, QL-Genealogist, is now available for the pointer 
environment as Genealogist-3. The new version has new and better features as well as access 
to the PE. 

When entering data, you can now choose from a “pick list’ that pops up a list of your previ- 
ous entries, allowing you to choose one to repeat instead of retyping it over and over again. 

A new “Country” field gives each address a three-letter country code which allows you to 
search and report by country. You can define your own three-letter code if you wish. 

Dates can be recorded as “approximate”, “before”, “after’, “quarter” or “invalid” - the last means 
that if a date is recorded wrongly in an official course (such as a parish register) you can list 
both the wrong date and the correction for cross-referencing. 

A new ‘Birth Brief’ report gives a pedigree chart with birth, marriage and death dates and 
locations, extracted from the research data files. 

Search facilities have been improved, with any string in a text field available for search, and a 
Pick List option in the Family Network. Search, load and save times for large Research Data 
segments have been improved. Gender (male, female or unknown) can be recorded and used 
in searches. 

The old “Notes” feature has been replaced by two new facilities: the ‘automatic’ notes from 
the Research Data are now called “Events” and kept separately from your own notes. The new 
“Notes” is an extra research segment with place and source fields, as well as comment, event 
type and date. 

Two windows in the Family Network can now be open at once, allowing you to keep track of 
where you are in your family more easily! And also to change relationship data using a mouse 
to point, rather than typing in reference numbers. 

There are many other improvements, many suggested by active users of QL-Genealogist 
Second Edition. Genealogist-3 comes with a complete new two-part manual and tutorial for 
new users and upgraders. The second part is an easy-lookup reference manual. 

The new version requires a minimum 512K memory expansion. A conversion program is 
included to translate your old QLG files into the new format with new, faster loading times. Chris 
Boutal himself will translate your files for you if you send him a COPY of the data on a 3.5-in 
disk with formatted blank disks and return postage. 

Prices for the programs are: Genealogist-3 with necessary Pointer Environment files: £60; To 
upgrade from QL-Genealogist Second Edition £33; To upgrade from the original QL- 
Genealogist First Edition £45; to upgrade from the Budget (128K) QLG £50. All enquiries and 
orders to Dilwyn Jones Computing, 41 Bro Emrys, Tal-y-Bont, Bangor, Gwynedd LLS7 3YT, 
UK. Tel. 0248 354023. 

Hey! When will Dilwyn and Chris get together and offer QLG versions and QL hardware as a 
complete good-value family tree package? Family tracing is one of our most popular hobbies 
and there must be many family tracers who have never heard of the QL, who would jump at the 
chance of an all-in-one computer system at a bargain price. 


ALL FORMATS DIARY 


Coming dates for the All Formats Computer Fair are: 

24 Oct West: Brunel Centre, Templemeads Station, Bristol; 30 Oct. North east: Northumbria Centre, Washington Dist. 12; 
31 Oct Leeds University Sports Centre, Calverley St; 6 Nov Oxford Cowley Parish Hall; 7 Nov Brighton Corn Exchange, 
Church St; 13 Nov West Midlands National Motorcycle Museum, M6 junction 23; 14 Nov Cardiff University Union, Park 
Place; 20 Nov London Sandown Park Racecourse 21 Nov Portsmouth Guildhall 27 Nov Haydock Park Racecourse, M6 J23 
28 Nov Brunel Centre, Temple Meads Station, Bristol 4 Dec Leicester De Montfort Hall, Granville Road 5 Dec North East: 
Washington Leisure Centre, District 1. 

The All Formats Fairs are going to many more venues now. Although you will not find QL traders at every one, they are 
good browsing places for multi-format users and general supplies. Check with suppliers whether they will be at a particular 
Fair. If you have far to travel phone All Formats 0608 663820 to check arrangements haven't changed. 

Day tickets are £4; you can get up to 50 £1-off vouchers by sending an SAE to the organisers at: Maple Leaf, Stretton-on- 
Fosse, Moreton-in Marsh, Gloucestershire GL56 9QX. (Only one voucher per ticket) Photocopies of these vouchers are 
OK. Admission is a flat £2 between 2pm and 4pm (£1-off vouchers do not apply at these times). 
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ICHANNEL 


Open Channel is where you have the opportunity to voice your opinions in Sinclair QL World. Whether you want to ask for 
help with a technical problem, provide somebody with an answer, or just sound off about something which bothers you, write 
to: Open Channel, QL World, The Blue Barn, Tew Lane, Wootton, Woodstock OX7 1HA 





Safer Post 


Following last month's let- 
ter Tragic Loss, we decia- 
ed to investigate postal pro- 
tection further. What we dis- 
covered is this: currently a 
Certificate of Posting does 
provide some compensa- 
tion for lost goods, but not 
the £150 as Mr. Fisher 
believed. The Post Office 
warned us that a rise in 
postal rates is due, and not 
to rely on current figures, 
but cover for normal post 
and therefore under a 
Certificate of Posting, as we 
_ write, is around £24. 

For increased cover, you 
should consider using 
Registered . Post - or 
Registered Plus. Both these 
services cost in the region 
of £3.00 an item up to 2 
kilograms weight. 
Registered post gives insur- 
ance cover of around £500, 
and Registered Plus 
around £1500 or £2000+, 
depending on the exact 
value of goods and charge. 
Additionally, both these ser- 
vices give a guaranteed 
next-day delivery, and Sig- 
nature on delivery. This 
gives owners extra security. 

You should not risk sena- 
ing items more valuable 
than the insurance cover 
given by these services, or 
any claim will be limited or 
invalidated. Parcels 
between 2 kg and 10kg 
attract a higher charge, 
around £14. In this case it 
may be worth investigating 
Post Office Parcel Force, or 
anotiier carrer. 


Your repairer should 
always be willing to send 
your goods by protected 
post on request, even if he 
charges you for the service. 

You can get leaflets on 
these services at your Post 
Office, but always check 
the date of printing (usually 
on the back page) in case 
prices out of date. 


Back issues 


Thank you for your letter 
with information about the 
New User Guide. | note the 
information about sources 
of back numbers of QL 


‘World. Your help has been 


much appreciated. 
E D Hyam 
seascale 
Cumbria 


In a nutshell: if Arcwind 
doesnt have the backissue 
you need, try Ron Dunnett 
at Qubbesoft He has made 
a point of getting hold of 
some older ones. 


Who and 
When? 


Greetings. 

| include a check to keep 
the subscription going for 
another 12 months. Now 
two little complaints: Why is 
no reference made in the 
entire magazine to the 
actual printing or issueing 
date? This is a very annoy- 
ing source of confusion 
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when one tries to relate an 
ad or article to the actually 
concerned date! 

Why don't you mention in 
your Club Access Sweden's 
Svenska QL Gruppen? 


When ~ you mention 
International Or 
Conference which is 


among us of very reduced 
importance and according 
to its own SysOp’s words 
“doesn't handle much 
about QL now-a-days’? 
Why not mention both 
instead? We very often 
mention you! 

The complete address is 
Svenska QL Gruppen, 
Toftaasgatan 73, 421 74 
Vastra Frolunda, Sweden. | 
have NOT asked anybody's 
permission to pass on 
these informs, but | guess 
nobody will protest. 

Attentiously yours, 

Renato Costa Ferras 
Spanga 
sweden 


Thank you, Renato. There 
has clearly been a confer- 
ence on the subject in 
Svenska in recent months, 
as Michael Cronsten of 
International QL Echomail 
Conferences sent us a very 
similar point of view about 
the Sweden clubs a few 
weeks ago and the infor- 
mation has been incorpo- 
rated into Club. Club did 
not run in the last issue, but 
it should appear this time. 

The clue to the issue 
date is found in the second 
digit of the issue number: 
IL8 is the eighth issue for a 
given year, and relates to 


the eighth month (August). 
Our grip on the calendar 
has been rather loose this 
year. We are trying to do 
something about it. 
Meanwhile - cheat: look at 
the All Formats Calendar 
and see which are the ear- 
liest dates we list. The 
issue should appear before 
those dates 


Quill Driver 


This letter refers to 
Howard Clase’s printer dri- 
ver in Psion Solutions, QL 
World June 1993. | used a 
routine like the one sug- 
gested for a major number 
of translates in some of my 
own SuperBasic programs, 
but had not thought of 
using it with Quill docu- 
ments. Therefore “thank 
you” to Howard Clase. 

Using my QLs, located in 
different places, with differ- 
ent printers (a Canon 
BJ10ex, an old Olivetti DM 
290 and a still less recent 
Brother EP44), | dressed the 
routine (input from a _lis 
file, translates and output to 
printer) in a short program 
which starts by asking for 
the printer on duty and font 
required, reads the appro- 
priate translate codes from 
DATA lines, and does the 
job. It is very simple. 

The only trouble is (*But 
see below) that printing 
from Quill to a file, all type- 
face codes are lost (bold, 
underline, high, low). Is 
there any solution to this 
problem? 


(*4 days later:) Please dis- 
regard the last para in my 
letter of October 10th. The 
trouble is not with the pro- 
gram, but with a copy of 
Psion Xchange which 
caused me other trouble 
too. Working with a different 
copy of Quill, everything is 
fine and the Quill codes for 
the typefaces are very evi- 
dent in importing the _lis 
files from SuperBasic, and 
appear also to be the same 
as for my Olivetti printer) 


Ernesto P Braun . 


Rome 


Italy © 


PSION 3 


| am a sound engineer in 
the music business, and in 
1986 | bought the orignal 
Psion Organiser Il to keep 
- my addresses and other 
data while | was on tour. 
This was the first computer 
| owned, and | quickly 
became addicted to play- 
ing with the programming 
language and writing a few 
programs. | started looking 
for a home computer for 
letter writing, and a friend 
who ran a rehearsal studio 
sold me a QL This started 
a long relationship. 

| made a database of all 
the concert venues | had 
been to, and transferred 
this, very sporadically and 
with many glitches, to my. 
Psion. The only things | 
bought for the QL were the 
lce rom and mouse, and a 
few Ice proigrams such as 
Icicle and Mousart. With 
these and the old Psion 
Quartet | wrote all the stage 
specs and drew all the 
plans for Steve Harley and 
Cockney Rebel, Donovan, 
Roger Chapman, John 
Cale, Gary Glitter, etc. 

Last year | moved to 
Germany and struggled 
with my girlfriend's IBM for 
a while before dragging out 
my old QL | invested in a 
Gold Card and suddenly 
realised why | had never 
dropped the QL before. 
since then | have bought 


new disk drives, Xchange, 
and am. struggling along 
with Qpac 2 since no-one 
is writing any more Ice pro- 
grams. (A pity, since my 
Icicle-revised Psion suite 
worked a treat, and having 
all the commands from 
Archive available as a 
mouse-driven menu made 
it So much easier to use. 
Why has no-one written a 
pointer program like that?). 

Someone stole my brief- 
case in Paris last year and | 
lost my old Psion Orgnaiser 
(but not the data, as | had it 
all on a spare eprom at 
home) so | have now 
upgraded to the new Psion 
Series 3, a fine machine, 
but how do you connect it 
to the QL? 

| fully intend to carry on 
using the QL, and to master 
Qpac and the pointer sys- 
tem (| have just ordered 
QDesign and the Minerva 
rom), and this is not only 
because | like the machine 
so much. When | was back 
in England recently, | visited 
Ron Dunnet of 
Qubbesoft, and David 
Johnson, both of whom 
gave me good advice 
and were very friendly. 
(When's the last time 
your IBM supplier gave 
you a cup of tea in his 
home and explained a 
few programs?) and 
Jochen Merz over here 
is just as Open and help- 
ful. 

So here’s to the QL 
community and long 
may it Survive. 

Roy Wood (Aural 
Architect and Mixer 
Manipulator) 
Hamburg 

Germany 


PS Does anyone have 
an old copy of QLPaint 
from Talent laying around 
for sale? Mine dies with 
the “bad or changed medi- 
um” message and the 
oroblem seems to be the 
master microdrive which 
you need to start the pro- 
gram. Also | am missing to 
issues of QL World, May 91 

















and April 92, so if anyone 
has any spares... oh, and 
why does Glossary in 
Xchange not work? 


More questions in the PS 
than the letter! OK: Does 
anyone have a Psion 
Organiser 3 connected to a 
QL. Come to think of it, 
someone at Psion might 
know. Might. And here’s me 
telling everyone that Ron 
Dunnett has backissues. 
Well, he can't have them all. 
I'll look into it. And why 
does Glossary in Xchange 
not work? 


Random Keys 


My Keyboard Products 
(ed. note: Not seen in the 
QL business recently.) key- 
board has gone on the 
blink, it tyoes out random 
letters before typing the let- 
ter that you have just 
punched up. 

Can anyone guesstimate 


news later. 


The brightly coloured birdie on the cover, 
codenamed the Goodwin Budgie, is the collabora- 
tive product of Dave Barker's drawing, the QL's 
native colours, SuperBasic In Action's colour sepa- 
ration codes and HPDUMP from DIY Toolkit. 


Tf itt [ A ff 


Editor's Notebook 

Dilwyn Jones’ SuperBasic for Beginners is back 
this month, as is Alan Bridewell's Beginners; 
Machine code. Dilwyn is a busy man at the 
moment so we can't promise another episode next 
month, but he'll be back before too long. 

Well, it looks as though | was right about 
finishing this issue as you were reading the last 
one; although lexpected both to be a few days 
earlier. Believe it or not, we started earlier this 
month, and expect to start earlier again next month 
until we bear more relation to Real Time. 

Tony Firshman is in the process of launch- 
ing some new and interesting pieces of small- 
scale interface hardware (see our Eindhoven Show 
report earlier this year for a preview), of which more 


which chip is likely to be 
causing the problem? 

| managed to get a key- 
board from Bill Richardson, 
who went out of his way to 
help, but unfortunately the 
pin-out is different. 

Who can tell me how to 
connect an Epson type 3 
keyboard 5-pin DIN plug 
(type a) to a 6-pin-socket 
Keyboard Products inter- 
face? 

As you can see from this 
typing, | am in urgent need 
of a working computer. Oh 
for a typewriter with a 
spellchecker! 

John McNaught 
Ralston 
Paisley 


PS - | am no slouch with 
a soldering iron. 


Any information, please, 
to John via QL World. Bill 
was one person | would 
have mentioned. Try Tony 
Firshman too. 
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Process Controller 
from Di-Ren 


Hardware and software makers Di-Ren have reintroduced their Micro Process Controller 
(MPC) computer-controlled switching unit after revisions. The self-contained process con- 
troller can switch AC and DC voltages up to a maximum of 3 amps at 240 volts AC (mains). 
The internal electromechanical relays are controlled by sending information from a comput- 
er program to the MPC, which controls up to six circuits. A second MPC can be connected 
ni-line, allowing control of up to 12 circuits. 

A single MPC can be connected in-line with a printer, allowing the use of a printer and the 
MPC simultaneously. The MPC can be run as a background task by multitasking machines. 
PCs can use a TSR program for the same function, so that the computer is not tied up by 
the MPC unless very fine timings are required. 

Low-cost programs that allow both background and critical time control are available 
already for the QL and PCs from Di-Ren. 

The user documentation contains, as well as programming and connection instructions, 
suggestions on how remote control via a modem might be achieved. . 

The MPC needs a power supply of between 9 to 12 volts DC, 300 milliamps. This can be 
provided by 9 volt battreies, but for steady use a battery eliminator (external power supply) is 
recommended. 

The MPC is aimed at the hobbyist, educational and light industrial markets. Current users 
wishing to upgrade should contact Di-Ren on 0922 33580. For more information on cur- 
rent prices please contact Dilwyn Jones on 0248 354023. 

There is a colour brochure available. Prices given suggest that a working MPC with battery 
eliminator could-be set up for around £100. 





More Programs 
to Review: 





QL World has copies of some interesting 
programs which haven't been reviewed over 
the last year. We would particularly like to 
hear from anyone who has been using any of 
these programs, but if you have not and are 
interested in the subject, drop the Editor a 
line at address on the Open Channel pages. 

From Jochen Merz in Germany we have 
two games, Minefield (which requires the 
Pointer Environment and Toolkit 2) and The 
Oracle, a game with a mysterious solution! 
Both are on disk. 

From Dilwyn Jones Software, a suite of four 
programs by Care Electronics: Locksmithe 
and 4Matter, two data-copying programs, the 
former for microdrive only, the latter for micro- 
drive and disk data; MDV Toolchest, a col- 
lection of SuperBasic extras concerned with 
reading and writing mdv sectors, monitoring, 
and sector editing. On mvd; needs knowl- 
edge of file handling and Qdos. Sidewinder, 
which we have already mentioned - a vari- 
able-size screen dump printer, including 
labels and banners. Disk only. Also a small 
screen blanker program, Screen Dazzler, by 
Bruce Nicholls, on disk. 
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From Digital Precision, we have a number 
of Archive-related utilities, several ex-PDQL 
Some are recommended for “Archive 
techies” and some for “non-Techies.” The 
“Non-techie” ones are: Mailmerge; Names 
and Addresses Database System; Dat-A- 
PPoint Appointment Manager; Recover; 
Archive Tutorial; and a separate ‘odds and 
ends’ batch: Compare, and Copy. 

The “Techie” ones are: Archdev+RTM: 
Sedit and Screenprint; Pedit; Database 
Monitor and Analyser. 

All these are on disk. 

From SQLUG shareware, we have 
Disktidy with a PD index application (two 
disks). 

We also have a batch of small, low-cost 
disk programs from QBits: Conundrum (a 
word game); Early Learn (Spelling and time 
for young children); Storeman Sam (proft 
and loss educational game); QL Engine 
Demo (Attractive graphics demo. Needs 
Gold Card. Two disks). All these are on disk. 

Please contact the Editor if you would 
like to review any of these programs. 















16MHZ 68000 
HIGH SPEED 2% 2M BYTE 
PROCESSOR | Ne: = Cee RAM 


CUSTOM 
LOGIC 
CHIP 


DD, HD, ED, 
DISK 


INTERFACE 





BATTERY 
BACKED 
CLOCK 


eke eee eee 2 ee 





QL GOLD CARD 


£225 inc. (£200 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the QL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL's ROM and display memory and for the GOLD CARD's own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched’on the 
contents of the clock are copied into the QL’s clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT II and there |s a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required. The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 





See the QXL on: 


saturday 30th October 1993 
at 
St Joris College 
Roostenlaan 


Eindhoven 
NETHERLANDS 


MIRACLE SYSTEMS 











THE QXL 





The QXL turns the common PC into a QL compatible. The package comprises a half 
card that plugs into an 8 or 16 bit standard ISA slot and a diskette loaded with a QDOS 
compatible operating system and a Superbasic compatible interpreter. After installation 

simply type QXL and the PC will appear to be a QL allowing QL programs to be run from 
QL format diskettes. 


The card itself has a 32 bit 68EC040 processor running at 20MHz which gives a good 
turn of speed. This processor has access to its own RAM and so performance is virtually 
independent of the host PC whether it has an 8088 or a Pentium. !In fact the PC is used 
purely as an I/O system giving QL programs access to the PC's floppy disc, hard disc, 
keyboard, display, serial and parallel ports. The card itself has QL style network ports to 
allow connection to a QL network. The minimum PC specification required is an XT with 
EGA display and a spare standard slot. 


Varying RAM sizes from 1M up to 8M can be supplied. The smaller capacities can be 
upgraded to the larger ones and the cost is simply the price difference. Not all the RAM 
is available to the user programs; the 1M equates roughly with a TRUMP CARD QL 
memory size and the 2M with a GOLD CARD QL. 


During the lifetime of the QXL we intend to enhance the software to make use of the new 
hardware facilities of the PC such as SVGA graphics. As has been our policy with the 
TRUMP CARD and GOLD CARD we intend to provide software upgrades free of charge. 


QXL prices 
IM £295 (£255) 
2M £325 (£280) 


5M £410 (£355) 
8M £495 (£430) 


(prices in brackets for outside EC) 





INTERNATIONAL QL REPORT (IQLR) is a regular magazine that all QL 
users should read. It has articles for the beginner, the advanced user and 
every one else in between. Also, the international flavour combined with 
low advertising rates makes it probably the best place to locate QL related 
items. IQLR is run by QL enthusiasts whose proud boast is that they have 
never been late with an issue. If you do not already get it then ‘phone us 
now. One year’s subscription for 6 issues to any European address is 

elsewhere should contact SeaCoast Services, 


£22.00 and it’s worth every penny. Subscribers 
VISA MASTERCARD 
15 Kilburn Court, Newport, Ri 02840, U.S.A. direct. om 


Wiee on oan ees) Getetlit saeeet ee ee ee eee 


To: MIRACLE SYSTEMS Ltd, 25 Broughton Way, 
Osbaldwick, York, YO1 3BG, U.K. Tel: (0904) 423986 


Tel: (0904) 423986 


To place an order by phone 
please have your credit card 
ready. For overseas customers 
we charge the prices shown in 
brackets. 


To order by post, please fill in 
the form opposite or write to 
us quoting your credit card 
number and expiry date, or 
enclosing a cheque payable to 
MIRACLE SYSTEMS Ltd. 


Please send me 


| enclose a cheque to the value of: £ 


Or debit credit card LIL LLL LLL 
Expires je A 














Name Signature 


Address 
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Simon Goodwin checks out the latest Gold Card drives and explains 
fault diagnosis for all QL disk formats. 


is SuperBasic 
program is very 
useful despite its 
shortness. It 
enables you to test your 
disks. If you find bad sectors 
you can recover the remain- 
ing data with Revive, the 
disk utility that launched 
SuperBasic in Action at the 
Start of the year. 

The original version of this 
program was one of the DIY 
Toolkit disk utilities, released 
_ three years ago. Since the 
Gold Card has come out, 
bringing high and extra-high 
density disks to the masses, 
| have updated the program 
to work with all three types 
.of disk. | 

The new file has been 
added to DIY Toolkit Volume 
D, along with Revive and 
other utilities for the new 
disk formats. You can still 
use it with the oldest 180K 
and 360K drives as long as 
you change a couple of pro- 
gram lines, as_noted later. 


New Drives 


The Gold Card gives 
much accelerated disk 
ACCESS, as well as faster pro- 
cessing. All the disk formats 
turn at the same speed, but 
higher densities use extra 
Current and special coatings 
to record more on each 
track. The program can test 
Gold Card ED disks at 
around 34K per second, 
checking 3.2 megabytes in 
about the time they take to 
FORMAT. 

The secret of this speed is 


the FOR loop in line 530. 
This means that sectors are 
read in a scrambled order 
from each track; the scram- 
bling or ‘interleaving’ gives 
the QL just enough time to 
process the last sector, and 
be ready for the next sector 
number in the sequence. 

The original QL needed to 
let two sectors go by while it 
processed each one, but the 
faster Gold Card can read 
alternate sectors under 
SuperBasic control. The disk 
format of HD and ED disks 
uses this faster 1:2 inter- 
leave, and the FOR loop in 
CHECK_DISK works at that 
speed. Substitute the FOR 
on line 520 for the one on 
line 530 if you're using a QL 
or slow system. 

The interleave makes no 
difference in the case of 
Amiga Qdos, as it reads a 
track at a time. This is one of 
the few floppy disk utilities 
that runs faster on Amiga 
Qdos than on a real QL but 
the difference is small and 
more down to Mark J Swift's 
rewrite of the disk handler 
than the Amiga hardware. 

The latest Amigas have 
high density drives, and 
Mark's brother Frank has 
started work on a driver for 
QL HD disks. You should be 
able to use CHECK_DISK 
with DD and HD disks on 
the PC once the QXL 
SuperBasic interpreter is 
working, but you may need 
to tweak the interleave to 
Suit the rate your machine 
passes sectors between the 
PC and Qdos, 

So far ED disks are solely 


l 6 Sinclair QL World Vol. 2 Issue. 10 


the domain of the Gold 
Card. Sector number ten is 
only read in line 500 if this is 
an ED disk. There is an extra 
delay of five sectors to give 
superBasic plenty of time to 
interpret its way to the next 
GET command. Some PC, 
ST and Spectrum formats 
use a tenth sector to 
squeeze more onto the disk, 
so you might like to change 
the IF test so that they can 
be checked on the QL 

The program starts by ask- 
ing you the density of the 
disk you want to check: type 
E, H or D. The SuperBasic 
will not run on the old AH 
and JM systems because it 
uses WHEN ERRor to con- 
tinue after bad tracks. It suits 
Minerva, JS, MG, Thors and 
Amiga Qdos, although all 
but Minerva have faults that 
can lock the keyboard if 
WHEN ERRor is invoked 
from inside an expression. 
DISK_CHECK is safe as it 
does not do that. Just in 
case of a typing error, 
remember to SAVE the pro- 
gram before running it for 
the first time. 

Once the density is set the 
program runs automatically, 
testing each track and gen- 
erating a high-resolution 
colour map of good and 
bad tracks. If you use the 
Qpac2 window manager the 
display will vanish as soon 
as the program finishes. | 
am told that Qopac users get 
time to read the summary of 
faults and time taken if they 
add: 


660 PAUSE : HOT_DO “b’ 


at the end of the program, 
and press any key when 
they want to get back to 
SuperBasic. By default 
CHECK_DISK uses “FLP1_” 
as everyone has that drive, 
but you can direct it else- 
where by changing DRIVES 
in line 410. 


Compilation 


The program is compil- 
able but its speed is limited 
by the drive and device-dri- 
ver, not the processor, and 
you won't be able to do any- 
thing else with the drive 
while it is being checked. If 
compiling with Turbo, 
remove the second parame- 
ter ,sector from the GETs at 
line 500 and 540, and add 
this after each GET: 


sectorS=INPUTS(#3,512+1 
536*(kb=="e") 


Use SET_POSITION 
instead of GET, and your 
task will not need Toolkit 2 
and can be distributed with 
the Runtime Toolkit. 


Old Drives 


When QL disk drives were 
a rarity the 720K type was 
the most expensive. Many 
people started out with sin- 
gle-sided disks or drives 
with half the number of 
tracks: 40 instead of 80. The 
disk checker will work with 
these old disks as long as 
you tell it the number of 
tracks or sides. 

Line 150, right at the start 


of the program, sets the 
number of the last track. 
Tracks are numbered from 
zero, so this is 39 for a 40 
track drive and defaults to 
79, for 80 tracks. Regardless 
of the data density, all cur- 
rent 3.5 inch drives disks 
use 80 tracks, but place 
increasing amounts of data 
on each track: 4.5K per side 
for DD, 9K for HD arid 20K 
for ED, which uses ten 
blocks of 2K rather than the 
usual 512 byte sectors. 

Single sided drives have 
only one head to read and 
write the disk, halving their 
capacity. Sides are num- 
bered zero and one, and 
single sided drives lack side 
1. Change line 480 to: 


480 FOR side=0 


if you have a single sided 
drive. This only goes once 
_ round the loop, so you can 

replace both the FOR and 
END FOR (line 590) with a 
simple assignment: 


445 side=0 


This is more efficient as 
the assignment is not made 
for every track. It’s hardly 
worth making this change if 
you have a mixture of drives 
as you need the FOR loop 
again to use a double-sided 
drive, but you might like to 
give the user the option to 
set the number of sides and 
tracks. 


Diagnosis 


If you find bad tracks on a 
disk you can usually deduce 
the cause from their distribu- 


tion. Software faults usually. 


clobber one or both sides of 
track zero. This holds the 
directory and map, which 
are altered more often than 
later tracks. 

Mechanical damage, 
including coffee and Ribena, 
normally shows up as 
groups of bad tracks on one 
side. Some vendors format 
their disks to just the capaci- 
ty needed for the files; these 
will show ‘bad tracks’ where 
there is no format. 


QL World SuperBasic in Action DD/HD/ED disk checker 
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REMark QL/Thor XVI/Gold Card VIEW_DISK_GC 
REMark Copyright 1992,93 Simon N Goodwin 
REMark Optimised interleave for GOLD CARD 
REMark scans ED disks at around 34K/sec. 
REMark V 0.8, 18-10-93, Needs WHEN ERROR 
LET max_track=79 :REMark 39 for 40 tracks 


WHEN ERRor 
IF ERLIN=500 OR ERLIN=540 
PRINT #53" Track ";tCrue track?" side ";sside<>0;" BAD * 
bad=bad+i eek=1 INK 4,2 CONTINUE 
END IF 
PRINT #0;"Error at ";ERLIN;:REPORT #0 : STOP 
END WHEN 
MODE 4 .: OPEN #4,scr_512x256a0x0 PA PE Rot Aug: Ones CL Gendt A, 
OPEN #4,"scr_330x244a180x0" BORDER #4,1,7 
BORDER #4,2,128 PAPER #4,0 INK #4.,.7 : CLS #4 


SCALE #4,170,-84,-85 : CIRCLE #4,0,0,84 
AT #4 ,1,1 PRINT (#4 A"! Prack "3 
OPEN #5,"scr_168x240a8x2" 
PAPER #5,0,2 ENKeA5te7» 2. CLS) #54 
PRINT #5;\" VISUAL DISK CHECKER"\\ 
PRINT #5;"Pick capacity: D=720K"\"H=1.44 Meg E=3.2 Megs"\\ 
REPeat kpoll 

kKS=INKEYS 

IF k$=="q" OR k$=="h" OR kS="e" 
END REPeat kpoll 

IF k$=="e" devs="*D4E" 
STRIP #5,2 
DIM drive$(8) : bad=0 
drive$="flpi_" sectorS=FILLS(0,512+1536*(kS=="e"") ) 
t=DATE . 
OPEN_IN #3,driveS & devs 
AT #4..1,,44 PRINT #4;drives 

FOR true_track=0 TO max_track 

AT #4,1,7 : INK #4,7 : PRINT #4,true_track; 

track=true_track*65536 

FOR side=0,256 


CIRCLE #4,0,0,4 


CSIZE #5,1,0 


EXIT kpoll 


ELSE dev$S="*D2" & kS$ 


eek=0 INK #4,5 + (side<>0) 
IF k$=="e" GET #3\track+side+10,sectors$s 
IF NOT eek 


REMark QL: FOR sector=3,7,2,6,1,5,9,4,8 
FOR’ SeECTOr=698/7 1 3 SOUTHS 221, 4 
GET #3\sector+side+track,sectors 


TP eek, : INK #4,2 : EXIT sector 
END FOR sector 
END IF 


CIRCLE #4,0,0,83-true_track+side*2E-3 
END FOR side 

END FOR true_track 
AT. #4522), 1 PRINT 4, baay bau lt"; 
IF bad<>1 PRINT #47 "s"y 
AT #4,22,44 PRINT #43DATE-t;"..s"; 
REMark QPAC users may need: PAUSE 
CLOSE #3 CLOSE #4 CLOSE #5 


HOT DO ’b’ 
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Manufacturing faults show up as disks which fail to format to their full capacity - perhaps 1386 sectors instead of 1440, 
indicating six unusable tracks. CHECK_DISK will tell you which tracks are bad; if they are all on side 1 you might like to play it 
Safe and reformat the disk to use only the good side: 


FORMAT “FLP1_SingleSide*” 


The eleventh character of the name must be an asterisk. It is not recorded but tells the disk system to prepare a single- 
sided disk The quotes are needed so that SuperBasic does not confuse the asterisk with a multiplication symbol. 


Inner Limits 


The innermost tracks of a disk have highest numbers, and the highest data-density due to their reduced circumference. If 
only the inner tracks are bad, it might be worth using FLP_OPT or FLP_TRACK (depending on your interface - look in the 
manual) to reduce the maximum track number. A couple of disk utilities go the opposite way, formatting a few extra tracks 


which most drives can reach. 


| returned from Italy with one of Ergon’s HD disks, formatted to 1.52 megabytes by their new disk utility. We both have the 
Official Miracle drives and it works fine, but if tracks are going to fail the inner ones are second only to track zero in their vul- 


nerability. 


The top limit varies depending on the mechanism of your drive. It has been many years since drives used a spiral groove 
to move their heads, and spat them out onto the hub if stepped too far! You are unlikely to do any damage by stepping 
beyond track 79, but the manufacturers would not recommend it. 





It's a “LAOWATHCE, FOO pig in andgo 


Michael Jonas of NESQLUG has found yet another use for his QL 


Working in an industry 
where “IBM compatibility” is 
as common a phrase as 
“Good morning’, and a 
Macintosh Apple is no 
longer just a snack rolling 
out of one’s raincoat pocket, 
it gave me great pleasure to 
discover a feature that my 
QL has over these modern 
computing powerhouses. | 
was sitting on my couch, 
blanket draped over me to 
ward off the chill in the air 
that had seeped into my liv- 
ing room, when | decided to 
do some work on my QL. 
After placing the monitor on 
a small stand beside my 
couch, and plugging it, as 
well as the QL power supply, 
into a nearby wall outlet, | 
placed the QL on my lap 
ready to proceed with the 
task in hand. 

sitting in a cold room 
makes life difficult for some- 
one who is trying to be cre- 
ative. | had been sitting on 
my couch for nearly five min- 
utes, before | even started 
Quill. A letter had to be writ- 
ten, and the QL seemed 
more than a match to the 
task, but the cold was ham- 
pering my creative process. 

Having used Sinclair com- 


puters for many years, | have 
come to accept a common 
trait among all - Sinclair 
computers always generate 
a lot of heat. This was true 
with the ZX81. In fact, it got 
so hot that the computer 
would usually cease to func- 
tion after several hours of 
work. Now personally, | have 
never had that problem with 
my QL although I've heard 
others complain. The QL 
does, however, get very 
warm after about an hour of 
operation, which always 
concerns me, especially if 
I'm in the middle of impor- 
tant work. 


Getting Hotter 


This overheating has been 
seen as a disadvantage of 
the QL. “Bad design” and 
“poor manufacturing quality” 
have been used to describe 
this bothersome feature of 
the original black machine. 
But | found out, sitting in my 
cold living room, that it is 
actually a hidden feature of 
sir Clive’s wonderful 
machine. Now, if you place 
the QL on your lap as you 
are doing work, the extra 
heat that is generated 
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makes for a nice lap 
warmer. Why, a hot water 
bottle can’t sustain heat for 
as long as a QL stays warm. 
In fact, someone ought to 
market this idea. | can see it 
now, an appliance that not 
only warms your lap, but 
can be used to write your 
letters, balance your check 
book, and play some games 
when things get too boring. 
Imagine trying to do that 
with an IBM or Apple! 
Laptops don't generate very 
much heat, and neither 
does a standard PC key- 
board. You would have to 
put the entire chassis of a 
desktop PC on your lap to 
come close to the heat out- 
put of the QL. This would 
not only keep you shivering, 
it would probably give you a 
hernia. Just try to picture 
someone balancing a full 
desktop PC on their lap and 
typing a letter, straining 
under the excess weight. If 
this doesn't kill one’s cre- 
ative juices, then nothing 
will. Why then spend all that 
money on a personal com- 
puter? Just grab a slab of 


. granite and a chisel and 


have at it. 


This idea of computers as 
appliances is not as ridicu- 
lous as it sounds. Most 
major computer manufactur- 
ers, including IBM and 
Apple, are saying that 10 to 
20 years down the road, 
most computers won't be 
desktop models that people 
will sit at to key in informa- 
tion. The computer industry 
is Currently steering in the 
direction of smaller, more 
portable machines with 
multi-processor and multi- 
tasking architecture that will 
be as easy to use as today’s 
VCRs - just plug it into your 
tv and go, aS easy as any 
other household appliance. 

sounds to me like the 
industry is striving, aS usual, 
for what the QL already has. 
The QL is compact and 
portable, and can easily be 
plugged into your tv for easy 
computing. And it already 
has a multi-tasking operat- 
ing system, as well as a 
dual processor architecture. 
Add to this its laowarming 
capabilities, and nothing 
comes close to beating this 
bundled appliance in price 
and performance. | guess 
Clive Sinclair knew what he 
was doing when he named 
this machine the Quantum 
Leap. 





QNMATHS 


O The real thing 





Hilary Snaden runs the second part of Digital Precision’s maths 


collection. 


his review of the 

second part of 

DD thd ideale 

Precision’s 
mathematical software 
package got off to a less 
than ideal start when the 
first line of the boot pro- 
gram crashed my QL The 
culprit turned out to be 
MANDEL_CODE, a file 
which was loaded as an 
extension when it was in 
fact a machine code routine 
loaded by one of the pro- 
grams at run-time. 

Once the unneeded 
RESPR-LBYTES-CALL 
sequence had _ been 
removed there were no 
more problems with the 
other extensions on the 
disk - Turbo and Qliberator 
runtimes, a segment of 
Toolkit Il (not needed if TKIl 
is already available) and 
QLVAL, two extensions to 
Superbasic which were also 
on the first Qmaths disk. 


Mandelspeed 


The first program on the 
boot menu IS 
Mandelspeed which, as its 
name suggests, draws frac- 
tal images. 

To an earlier generation, 
“new” mathematics meant 
Boolean algebra and calcu- 
lus. Today's new mathemat- 
ics is concerned with 
Strange attractors, chaotic 
dynamics and fractals. The 
concepts may be even 
more difficult to grasp than 
those of calculus, but the 
results are certainly more 
interesting and relevant to 
the real world. The opening 


of this important scientific 
avenue is largely due to 
computers, which are well- 
suited to the rather mind- 
less, repetitive number- 
crunching which fractals 
involve. 

A number of Mandelbrot 
programs for the QL have 
appeared over the years, 
and one would expect a 
commercially-available pro- 
gram to have more to offer. 
The menu screen suggests 
that this is the case with 
Mandelspeed. 

Once an initial memory 
allocation has been made 
by specifying the maximum 
size (limited only by avail- 
able memory) of data table 
generated, the menu 
options can be selected 
either by pressing an initial 
letter, or highlighting via the 
Cursor keys, and pressing 
Enter. The program is 
somewhat sluggish in 
responding to Enter, but 


once it has caught on, it will. 


in most cases cycle 
through the available sub- 
options, or present a rea- 
sonable default. 


Inkblots 


Besides the normal co- 
ordinate data (defaulting to 
the location of the familiar 
‘inkblot” pattern) and itera- 
tion count (variable from 8 
to 250) there are a number 
of other options. 

The size of the image (or 
more accurately the size of 
the table from which the 
image is generated) can be 
defined, up to a maximum 
set when the program first 


starts. 100 produces quickly 
a small “test run” picture, 
and 250 a full (or nearly full) 
screen image. Larger sizes 
generate a larger table but 
no corresponding screen 
appears while the data is 
being generated. 

There would seem to be 
little point in setting the 
table size larger than 250 
since, although a larger 
table can be displayed, the 
extra detail will not be readi- 
ly apparent It may be possi- 
ble for a custom printer-dri- 
ver to use a large data table 
to generate high quality 
hardcopy, but this is not 
explored in the current ver- 
sion of Mandelspeed. 

The screen can be 
switched off to run 
Mandelspeed as a back- 
ground task while it is gen- 
erating its “virtual screen’. 
This is needed partly 
because the program 
appears to assume the cur- 
rent screen is at 131072 
and POKEs to it; conse- 
quently, the screen needs 
to be disabled even when 
Mandelspeed is run under 
the Pointer Interface. 

The machine code maths 
routine MANDEL_CODE 
reads the keyboard directly 
(via MT.IPCOM) for an abort 
instruction rather than the 
program's CON channel. 
Perhaps this is to avoid 
slowing the execution of the 
maths routine, but it makes 
background multitasking 
fiddly, as the keys (usually 
Esc) used to abort the cal- 
culation loops will probably 
need to be changed to 
avoid collision with other 
programs. 


Three Modes 


The documentation warns 
of the danger of “losing” the 
cursor if Ctrl-C is used to 
switch to another task while 
on the menu page. Maybe 
an active cursor on the 
menu page would have . 
avoided this. 

Three different 
Mandelbrot configurations 
and the Julia set can be 
selected, and three calcula- 
tion modes: Coarse, Two 
Pass and Slow, successive- 
ly generating more accurate 
pictures more slowly. 

A point can be “targeted” 
for use with the Julia and 
Twisted Mandelbrot dis- 
plays, either by entering the 
numbers directly or by mov- 
ing a crosshair over the cur- 
rent picture. : 

The Draw and Enlarge 
options generate a table 
and picture from the pro- 
gram’s current settings, or, if 
the settings are unchanged, 
redraw from the current 
table, which, not surprising- 
ly, is considerably quicker. 
Enlarge goes on to add a 
rectangular cursor which 
can be moved over the cur- 
rent picture, and shrunk 
enlarged, to select an area 
to be recalculated in greater 
detail. 

Both the Enlarge cursor 
and the target crosshair are 
manipulated via the cursor 
keys, which are somewhat 
tardy. It would be useful to 
have a co-ordinate display 
onscreen while the cursor 
moves. 

The 


Colours option 
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enables each iteration band 
to be individually 
recoloured, and it is easy to 
restore the “original” colour- 
ing. This enterprising facility 
would be even better if the 
colours could be paged 
through, rather than having 
to scroll through up to 250 
in sequence. 


fix pesin@eatcostyy R=l-4 pit pilxl-2 pi,? pr 


ations, size, calculation 
mode and target co-ordi- 
nates. By saving both the 
table and the data which 
generated it, they can later 
be reloaded for further 
investigation. 

The size of the data file 
depends on the table size; 
a table of dimension 250 
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Above: GLNIVEL SCREEN. (inverted colours) 
‘Below: 3D TERRAIN SCREEN. (inverted colours) 


loBIsigel'y 2-368 
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Save and Load 


A number of save and 
load options are available. 
“Table” saves or loads the 
complete “virtual screen” 
table, together with <a file 
containing its size and the 
number of iterations. “Data” 
saves or loads the image 
co-ordinates, number of iter- 





will produce a data file 
62500 (250x250) bytes long. 
The save options check 
that there is sufficient room 
before writing the file. 

The savable and loadable 
table is an excellent idea, 
unfortunately hampered in 
the review copy because it 
did not work. Co-ordinate 
information seemed to be 
saved accurately, but the 
program not only refused to 
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z=(-| 97776598 ,1 99675065) 80x46 


load it back again, but also 
would not properly allow 
the entry of new co-ordi- 
nates from the keyboard. 
The program now contains 
a perfectly accurate repre- 
sentation of a previously- 
saved table, but it has no 
idea of how it got there! 
This makes it practically 
impossible 
to re-use, 
since 
Enlarge will 
generate a 
different 
image from 
the one 
expected. 

T OM OP ts 
needs see- 
ing-to. If at 
the full data 
was saved 
and loaded 
| with _ the 
table, it 
would 
make the 
program 
easier to 
use, since 
the table is 
not much 
use without 
the data. 

You" can 
also save 
and load the 
colour map 
which has 
b een 
defined from 
the Colour 
option. 

There is a 
screen-save 
option for 
graphics 
printing pro- 
grams, 
though for 
some rea- 
Son a saved screen is a 
byte short of the full 32768, 
which can cause problems. 

The remaining file options 
set the data device and file- 
name and obtain a directo- 
ry listing. 

In fractals there is some- 
thing for everyone. For the 
orogrammer, the challenge 
that however quickly and 
accurately the calculations 
are made there is always 
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more detail tantalisingly out 
of reach. For psychologists, 
philosophers and artists 
there is the striking analogy 
that the most fertile areas of 
the image are at the very 
borders of the unconscious - 
central dark and the con- 
scious Outside areas. For 
those in pursuit of life’s aes- 
thetic pleasures, there is the 
inexhaustible beauty of the 
images themselves. 

This beauty is apparent 
even with the QL's relatively 
modest display in Modeég, 
and Mandelspeed could 
have a great deal to offer 
the fractal enthusiast if the 
snags found in my review 
copy were expunged. 


3D Terrain 


3D Terrain draws three- 
dimensional landscapes. 
Exactly how the basic pic- 
tures are produced is not 
revealed by the documenta- 
tion, and the user cannot 
add to the twenty already 
supplied. 

A large number of options 
on the main menu allow 
parts of the “landscape” 
models to be selected and 
manipulated. The angle and 
distance of the viewpoint, 
and so the perspective, can 
be altered, the vertical axis 
expanded, and the resolu- 
tion adjusted to produce a 
rough-and-ready outline or 
a detailed picture. Screens 
can be drawn in Modeé4 or 
Mode8, and saved to a file 
or dumped to a printer. 

As with Mandelspeed, the 
most interesting pictures 
are a long time a-coming, 
but unlike Mandelspeed 
you cannot write a ‘virtual 
screen” as a background 
task while the machine 
does something else. 

3D Terrain’s develooment 
on a 128K QL shows con- 
siderable ingenuity on the 
part of the programmer, but 
unexpanded QLs are rarer 
than they once were, and 
the program is certainly 
unusual and interesting 
enough to be worth devel- 
oping a version which can 


use available memory to 
hurry things along, or at 
least use Qdos’s multitask- 
ing through the ‘virtual 
screen” approach. 

The program would be 
more flexible as a single 
executable task; in its pre- 
sent form it behaves oddly 
in the presence of the 
Pointer Interface, which is 
gaining popularity. 

A short Basic program 
supplied illustrates some of 
the principles involved in 
3D Terrain, but the best way 
is to experiment. A certain 
amount of patience is 
needed. 


QLVAL et Al 


The QLVAL SuperBasic 
extensions were first intro- 
duced in Qmaths 1, where 
they were used in the 
Surface Modeller program. 
Here they are used in three 
further programs, Qalc, 
Numint and Glnivel, and 
properly documented in 
their own right. 

When loaded with either 
a RESPR-LBYTES-CALL 
sequence or an LRESPR 
command, QLVAL adds two 


new functions to 
SuperBasic, CMPILA$ and 
VAL. These provide 


SuperBasic with a facility 
analogous to VAL in other 
Basics, so that mathemati- 
cal expressions can be 
evaluated in the form of text 
strings. 

QLVAL does this in two 
stages to maximise speed. 
First, the expression to be 
evaluated is fed to CMPI- 
LAS, which returns an 
equivalent string to be 
stored as a Superbasic vari- 
able. This can then be eval- 
uated for specific values of 
up to five variables in the 
original expression (desig- 
nated x, y, z, u, and v) by 
feeding it to VAL along with 
the appropriate values of 
XV. 

In this way the relatively 
slow process of converting 
the human-readable text 
expression into a form 
which the QL can more 


easily understand only 
needs to be done once for 
each expression. 

The two functions are 
used something like this: 


f$="asin(sin(x)sin(y)+cos(x) 


cos(y)cos(z))” 
t$=CMPILAS(f$) 
y=RAD(52) : z=RAD(37) 
P cmetl ath di, 

VAL(t$,0,y,z) 
PaRiol=Ned-k 

VAL(S,PI/2y,2) 


Unset variables cy 
(in this case u <3 
and v, not actual- 
ly used here) 
default to 1. 

The CMPILA$ 
function is more 
flexible in its syn- 
tax checking than 
SuperBasic, so 
expressions can 
be entered ina 
style which math- 
ematicians would 
find more familiar, 
and the exten- 
sions are likely to 
be useful to any- 


one writing 
SuperBasic pro- 
grams which 


need the input of 
mathematical 
functions. 

For assembly 
language hack- 
ers, the source 
files, with Copious 
commentaries (in 
Spanish!) are sup- 
plied archived on 
the Qmaths disk. 
Users tinkering 
with the code are 
requested to 
inform Digital 
Precision. 


Qailc 


Qalc is a compact scien- 


tific calculator, accepting 
input as expressions in the 
text format expected by 
CMPILA$ function. The 
results of the three most 
recent evaluations are 
stored in variables x, y and 
z, which can be recalled 
and used in other expres- 


sions. Two further variables 
can be user-defined. 

some expressions, for 
example sin(pi/2), can pro- 
duce confusing results. This 
is due to rounding errors 
introduced by Qdos’ maths 
routines rather than the 
coding of this neat and effi- 
cient program. 


“4 Functions sindd+sin(2x) 

Interval: [= pi,pid (=[-3,1¢159265,3. 14159265) 
<< Integral: 141 
S« Bound dr2: 1{=1 
vy Bound_g4: LGD 


ate, oe 
Ra mapa hag tear eachon 


(if known) the exact value of 
the integral and the upper 
bounds of the second and 
fourth derivatives. 

You can then select from 
the Trapezoidal rule, 
Simpson's rule, or two vari- 
ants of Gauss’ method, 
whether or not to plot the 
integral as well as the origi- 


ue : Graph function 
| Compute integral 


| «Trapezsidal rule 


Simpson's rule 
Gaues method-4 


«Gauss nathad-7 


Above: NUMINT SCREEN. (inverted colours) 
Below: MANDELSPEED SCREEN. 


The restore-screen facility 
and the presence of an 
active cursor means that 
Qalc can be multitasked 
with the minimum of bother. 


Numint 


Numint calculates and 
plots the integral of a sin- 
gle-variable function over an 
interval. The function, 
bounds and number of 
points are entered first, then 


_ Fixed a, not error 


Fixed 9, bounded error 


~ Fixed n, estimated error 
5 


xéd error, m by bounding 
Fixed arror, n by estimation 








nal function. Various permu- 
tations of fixed, bounded 
and estimated errors and 
values of n are offered. 

F4 toggles a trace mode 
which displays intermediate 
values of the function for 
fewer than fifteen points, 
and F5 brings up a minia- 
ture scientific calculator. 

The captions “With inte- 
gral curve” and “Without 
integral curve” seem to 
have become transposed, 
but apart from that the oper- 
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ation of the program is 
exemplary. j 

Numint looks neat and 
professional, is so straight- 
forward it is almost self- 
explanatory (using almost 
exclusively up, down, Enter 
and Esc.) and very fast. 


Ginivel 


Glnivel plots the function 
fxy)>=z over a rectangle in 
the plane OXY for a real 
value of z. The options 
available are not at all 
apparent from the program, 
and even with the help of 
the documentation | need- 
ed a fair amount of experi- 
ment to make them work 
properly. 

Once the function, the 
corners of the rectangle 
and the required resolution 
in x and y have been 
entered, press F4 to enter a 
value of z for which x and y 
will be plotted as a line or 
points, or Shift-F4 (not Ctrl- 
F4 as stated!) to enter a 
value of z and a colour to 
fill a region f(x,y)>z. Ft 
restarts the program, Shift- 
Fi prompts for a new func- 
tion, F2 a new rectangle 
and resolution and F3 a 
new resolution. 

Since there is no error 
checking of data input it is 
extremely easy to bomb out 
of Glnivel with a Turbo error 
message, and, like the 
Surface Modeller program 
on the first Qmaths disk, 
very little coding has been 
spent on_ presentation. 
Many users might feel 
intimidated by a program 
which starts with a.screen 
wholly blank apart from the 
prompt “fxy)="-in the bot- 
tom left corner, and even 
adept mathematicians can 
make mistakes during data 
entry. 

Both this program and 
Surface Modeller produce 
good quality graphics, but 
both cry out for a more 
friendly presentation. 
Numint and Qale demon- 
Strate that mathematical 
programs can be functional 
and look good. 

The Superbasic sources 


of Qalc, Numint and Glnivel 
are in an archived file. 


Acalc and 
Rpcalc 


Acalc contains the maths 
routines for the high preci- 
sion calculators in Qmaths 
1. An extension which 
makes the routines avail- 
able to SuperBasic via the 
keyword ACALC, and the 
assembler source file, are 
supplied. 

Rpcalc is a configurable 
version of the high preci- 
sion calculator. The Basic 
source, and a compiled ver- 
sion and SuperBasic con- 
figurator, are supplied. 

A good working knowl- 
edge of SuperBasic, Qdos, 
and assembly language 
programming is needed to 
make the most of these 
files. 


Abacus 
Compendium 


By far the largest file on 
the Qmaths 2 disk is an 
archive containing a num- 
ber of files which would oth- 
erwise not fit on a 720K 
disk. These can be extract- 
ed from the Extract option 
on the boot menu, by run- 
ning the program 
UNPACK_BAS, or by using 
directly ARC as supplied on 
the disk. 

Among these files are 
over 500K of Abacus 
spreadsheets. There is little 
documentation on the 26 
_aba files, and from stan- 
dard deviations and confi- 
dence intervals to multiple 
linear regression and 
beyond, they are for 
advanced statistical analy- 
sis. Those to whom Kruskal- 
Wallis, Mantel-Haenszel, 
Mann-Whitney or Kaplan- 
Meier mean anything may 
think they have struck gold. 


Overview 


It is difficult to avoid com- 
menting on the packaging 
of the two Qmaths disks. 
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Here are two enterprising 
and ambitious fractal pro- 
grams which in some ways 
represent the cutting edge 
of modern maths while 
offering much on aesthetics 
too; a number of programs 
dealing with more tradition- 
al calculus: and one pro- 
gram which seems to fall 
between the two. Here is 
assembler code for mathe- 
matical manipulation and 
some tools for highly 
advanced statistical analy- 
Sis. 

Those whose interests lie 
mainly in exploring fractals, 
or in traditional calculus, or 
in statistics, might feel 
aggrieved at having to buy 
both Qmaths to get what 
they want. 

Users of maths software 
are likely to want to multi- 
task the most useful pro- 
grams. Unfortunately this is 
difficult because of the vary- 
ing degrees to which the 
programs tolerate the 
Pointer Interface (which is 
the most straightforward 
way of multitasking conve- 
niently). 

All the programs are per- 
fectly usable, but | cannot 
helo feeling that the valu- 
able ideas in Qmaths could 
have been made even 
more practical by attention 
to this point. 


Matters 
Arising 


It is possible to view the 
final, “official,” Sinclair 
releases of Qdos as the last 
word in QL firmware, .warts 
and all. On the other hand 
there is an argument that if 
the QL is to survive and 
grow, Qdos must find a way 
of continuing to develop in 
something like the way 
which its original designers 
planned. 

Minerva is probably the 
best-known example of this 
thinking turned into action, 
and Qptr and Qpac can be 
viewed as optional but no 
less integrated develop- 
ments of the original oper- 
ating system. We are now 





within view of SMSQ run- 
ning on the QXL as well. 

It is not in the least com- 
pulsory that software should 
make use of such “extras” 
as Minerva’s second 
screen, or the Pointer 
Interface, but it is disap- 
pointing when new releases 
clash with them. 

The QL community has 
every reason to be grateful 
to Digital Precision for their 
support, and for opening up 
the kind of deeds that the 
QL can be persuaded to 
do, but time and tide are 
rushing on, making new 
demands on programmers. 

Anyone wishing to find 
out more about fractals and 
related ideas may like to 
investigate the following 
books: 


lan Stewart: Does God 
Play Dice? 

James Gleick: Chaos. 

Hans Lauwerier: Fractals. 

Benoit Mandelbrot: The 
Fractal Geometry of 
Nature. 


(Editor's note: We can't 
guarantee that these title 
are all currently in print, but 
they should all be by order- 
ing from a public library, 
even if all the details are not 
known.) 


TRE 
NEW 
SER GUIDE 


KEYWORD INDEX 








This month in the Keyword Index Mike Lloyd is working 
on his IAN and making multiple copies with WCOPY. 





TAN(radians) 


TRIGONOMETRY FUNCTION 
radians A floating point value representing an angle in radians. 


The tangent of an angle is the ratio of its sine and cosine. The TANQ function returns the tangent of the 
angle represented by the parameter passed to it. As with all other trigonometric functions, the angle must 
be measured in radians. A further explanation of tangents will be found in the Concepts section of the New 


& User Guide. 


TK2_EXT 
[Super Toolkit |i] 


SUPERBASIC LANGUAGE DIRECTIVE 


some of the keywords contained in Super Toolkit Il have been incorporated under licence in disk 
controllers and memory expansion units from manufacturers such as Miracle Systems. In some instances, 
‘the code supporting the keywords was slightly modified, or is now superseded by improved versions from 
later editions of Super Toolkit Il: The TK2_EXT command forces the QL to ignore any keyword definitions it 
finds except those defined by Super Toolkit II itself, Refer to your hardware documentation for instructions 
for using the FLP_EXT and EXP_EXT cousins to this command. 


TRUNCATE #chan, 7 


position 
[Super Toolkit I] 
FILE HANDLING COMMAND 
| #chan A channel opened to a file 
ce position(Optional) An integer representing a character location within a file 


During low-level file-handling it can be useful to reduce the length of a file. Without the TRUNCATE 
command this could only be done by loading the file’s contents into the QL’s memory and then saving 


TURN #chan, angle 
TURNTO #chan, angle 


TYPEIN stringS 
[Turbo Toolkit] 


back only part of it The TRUNCATE command can take a new position point as a parameter or it can 
close the file at the file pointers current location. 


TURTLE GRAPHICS 
#chan(Optional) A valid screen channel 
angle An angle measured in degrees (not radians) 


TURN and TURNTO are basic features of the turtle graphics language set. Turtles are invisible graphics 
cursors that leave traces behind them when the MOVE command is issued, provided their pen is down. 
TURN rotates the turtle a given number of degrees. Positive values cause the turtle to twist clockwise, 
negative values turn the turtle anti-clockwise. A tum of -40 degrees is exactly the same as a turn of 320 
degrees. The TURNTO variant of this command points the turtle to an absolute reference with 0 degrees 
pointing vertically upwards. 


*k 


COMMAND INPUT UTILITY 
stringS A text string or character variable containing valid SuperBasic commands 


One of the minor benefits of a multi-tasking computer system is the ability of one task to offer data 
to another. This is particularly useful when the receiving task is the SuperBasic interpreter, because 
an application can trick it into thinking that input is coming from a human operator typing at the 
keyboard. This allows you to build test suites wnere key sequences are played back to see if 
modified programs work as expected. You could create demonstration or tutorial utilities which drive 
an application by simulating keyboard activity. Alternatively, you could write macros to take the 
drudge out of regularly-used command sequences; for example, all of the commands to restore the 
default windows to your preferred sizes, locations, colours and character sizes might be executed by 
pressing just one key. 


To understand what TYPEIN does, you must know a little about how keypresses become input for 
the SuperBasic interpreter. When a key is pressed, an electrical connection is made in a mat under 
the keyboard that is transmitted to the QL’s motherboard where a byte with the appropriate ASCII 
value is generated and stored at the end of a queue in the keyboard buffer - an area of RAM. The 
SuperBasic interpreter regularly inspects the keyboard buffer and extracts characters up to the next 
Carriage return and tries to interpret what it has read as a SuperBasic command. When several 
programs are running simultaneously one of them will call the keyboard buffer its own and fend off all 
attempts by other programs to read it. Pressing Ctrl-C switches control from one multi-tasking 
program to the next, and with it the keyboard buffer. 


TYPEIN works by stuffing a string of characters directly into the keyboard buffer. With only three 
exceptions, Qdos is quite unable to distinguish between such characters and those that arrive 
conventionally from the keyboard itself. Because of their unique roles, the following combinations 
cannot be included in a TYPEIN string: Caps Lock, Ctr-F5 and Ctrl-C. 


The string that follows TYPEIN can contain anything that could be typed in at the command line. 
You can opt simply to stuff a command into the command interpreters buffer and wait for the user to 
press the Enter key, or you can force SuperBasic into action by including a CHR&(10) at the end of 
every command. A TYPEIN string can contain many commands separated by CHRS(10)s. Strings that 
appear as parameters within TYPEIN’s command string should have single inverted commas inside 
the double inverted commas delimiting the string, or vice versa. The following example shows both 
these points in action: 


100 TYPEIN “PRINT#O, ‘Hello’ “ + CHR&(10) + “CLS #2” + CHR&(10) 


To make full use of TYPEIN in conjunction with the SuperBasic interpreter you will also need to use the 
COMMAND_LINE procedure in the Turbo Toolkit. 


cs UNDER #chan, toggle 


VER$ 
[SuperBasic] 
VERS (flag) 
[Minerva] 


VIEW #chan, source, 
target 
[Super Toolkit |I] 


There are two pitfalls to avoid with TYPEIN. If you execute programs with EX_W or EX_A, or any 
other of their ilk, the SuperBasic interpreter is disabled until that program is completed, so TYPEIN is 
limited to simulating keyboard activity for that application alone. Secondly, the KEYROW command 
bypasses the keyboard buffer to read keyboard activity at a lower level: in order to prevent confusion 
between keypresses read instantly with KEYROW and those patiently waiting in the buffer queue 
QDOS empties the keyboard buffer before accepting a KEYROW character. (Incidentally, this feature 
can be turned to your advantage because there are several occasions when the buffer should be 
emptied of stray input and KEYROW is a good way to do it) 


TEXT DISPLAY PROCEDURE 
#chan (Optional) A valid display channel (default is 1) 
toggle 1 represents underlining, 0 represents no underlining 


The UNDER command toggles between underlining and non-underlining (the default) for all text 
subsequently printed to the window concemed. Underlining appears in the same ink colour as used by 
the text. A quick way to achieve underlining of a different colour is to print the text once with underlining 
enabled and then overtype (with OVER -1) in a different colour without underlining. UNDER does not 
underline text sent to the printer. 


SYSTEM FUNCTION 
flag(Optional) Indicates which information to return from the following list: 


2 The base address of the Qdos system variables area 
1 The ID value of the currently executing job 

0 The revision number of SuperBasic (the default) 

1 The revision number of Qdos 


In simple SuperBasic using a Sinclair rom, VER$ is a plain and unassuming utility function that simply 
reports which version of the rom is inside your computer. If the rom is a Minerva from QView then VERS 
can take one of four parameters, one of which is actually useful. The base address of the system 
variables area is an essential piece of information for those who circumvent some of SuperBasic’s 
weaknesses by accessing Qdos tables directly. For the most part the system variables can be assumed 
to begin at a given address and once found, provided the QL'’s configuration remains unaltered, the base 
address can be relied upon for session after session. However, this cannot be relied on if you are writing 
for several machines, or for machines with different configurations, or for virtual QLs running with Atari or 
IBM-compatible hardware, or for future revisions of QL roms. VERS(-2) is therefore a genuinely useful 
function, although Turbo Toolkit's family of BASIC_B%-related functions incorporate the same facility. The 
other variants in Minerva’s VER$ are less likely to be valuable, but are nevertheless welcome. 


FILE MANAGEMENT COMMAND 
#chan (Optional) A valid output channel 
source The name ofa file to be viewed 


target (Optional) The name of a file receiving the source output 


VIEW is a neat alternative to the clumsy COPY command when you want to view a file's contents on 
screen. Instead of opening a temporary Qdos window with its unattractive defaults, VIEW places its output 
into an existing window, truncating long lines rather than wrapping them. So that you can view each 
screenful of output at your leisure, VIEW periodically inserts a Ctrl-F5. If its output is sent to a printer or a 
file, VIEW chops off each line at the eigtieth character. 


WCOPY #chan, name 
TO name2 

WDEL #chan, name 
WDIR #chan, namet 
TO name2 

WREN #chan, name 
TO name2 

WSTAT #chan, name’ 
[All from Super Toolkit II] 


FILE MANAGEMENT COMMANDS 
#chan (Optional) A valid output channel, used for screen dialogues 
namet A full or partial filename (see below for details) 
name2 A full or partial filename (see below for details) 


SuperBasic file management commands operate only on one file at a time. In Super Toolkit I! 
many of them have been given a more powerful equivalent that operates on all files sharing 
similar filenames. For instance, a single command can copy all word processing files with the 
suffix “_doc” from one microdrive to another, or delete all files beginning with “flo1_junk_’, or 
renaming all files beginning “flp2_work_” with the prefix “mdv1 _”. 

Super Toolkit wildcards are in fact prefixes and suffixes separated by underscores from the 
main filenames. These elements of filenames are also the QL's equivalents of the directory 
structures found on IBM-compatible computers. The first part of a full filename identifies the 
device, such as “flp1_” or “mdv2_”. There can then follow several filename segments separated 
by underscores as there is room for within the overall maximum filename length. For most users 
it is enough to provide even ED disks with just one or two subdirectory levels. You might wish to 
rename all the executable files “flp1_prog_” followed by their usual name and then ensure that all 
your datafiles are prefixed “flo1_data_” or “flp1_work_”. With Gold Card you can even get the 
Psion applications to play along as subdirectories can be given virtual drive names - in other 
words all files with names beginning “flp1_work_” can be made to appear as though they were 
on a drive called “flp3_" 

Once you have sorted out your disks and microdrives in this way full use can be made of the 
wildcard versions of SuperBasic’s file handling commands. The wildcard commands have all the 
same functionality as their normal equivalents but they operate on every file sharing the same 
prefix or suffix. The command: 


WCOPY flp1_ TO flp2_ 


will copy every file on the first drive to the second. At the outset of this operation you will see a 
screen message similar to “Copy flp1_ to flp2_. Proceed?” and offering the options of pressing Y, 
N, A and Q. These letters have the following meanings: 


Y Yes, take action on this file 

N No, do not action this file, but continue with the next 
A Yes, action all files matching the wildcard 

Q No, do not action this file or any others (ie Quit) 


The same options are presented no matter which wildcard file command is used and they are 
consistent with Super Toolkits enhancements of the standard equivalents. By default the text 
appears in the command window (#0) but you can change this by including a channel 
parameter. 

Some practical examples of using wildcards follow. See the New User Guide entries for the 


root keywords for a full explanation of their syntax. 
Archive all your old documents from a work-in-progress area by typing: 


WREN _doc TO archive 

Backup a microdrive to a disk subdirectory by typing: 

WCOPY mdv2_ TO flp1_backup_ 

Delete document files accidentally stored in the program area (note the use of two adjacent 
underscores, without an intervening space, indicating where in the full filename a match needs 
to take place): | 

WDEL flp1_prog_ _doc 

List all the Abacus files on a microdrive: 

WDIR mdvi_ _aba 


List the size, age and type of all files on a floppy drive to a file: 


OPEN #6, flp1_statistics 
WSTAT #6, flp1_ 


Very Basic 





Sup 





erBasic 


Part 6 


Dilwyn Jones uses some colourful language this month! 


e QL is blessed 
with a pretty good 
range of easy 
graphics com- 

mands. This month, I'll intro- 
duce simple colour control 
and general screen han- 
dling. These facilities have 
been enhanced on new 
hardware - systems such as 
the QXL and Atari ST emula- 
tor have added new screen 
resolutions and so on - but 
for now we shall ignore 
these in favour of the facili- 
ties built into the humblest 
unexpanded QL 


Screen Modes 


The QL has two screen 
modes. These can be seen 
on first starting up the QL, 
though they may not be 
obvious! One mode gives us 
a choice of up to 8 colours, 
while the other gives only 4, 
but with a greater amount of 
detail possible on the 
screen display. 

What could be simpler 
than the command to 
choose between them. 
Mode4 switches the QL into 
the four-colour mode, while 
Mode8 switches to eight- 
colour mode. As new hard- 





ware gives better graphics 
facilities, it seems likely that 
there will be other values 
which may be used. Minerva 
system users already have 
extended mode commands 
to choose a variety of 
options. 

Mode4 gives us only 
black, red, green and white 
to choose from, but Mode8 
also adds blue, magenta, 
cyan (a light blue colour) 
and yellow. All of these 
colours have numbers 
which denote the colour 
value. 


0 = Black 

1 = Blue 

2 = Red 

3 = Magenta 
4 = Green 

5 = Cyan 

6 = Yellow 

7 = White 


In Modeé4, if you ask for a 
colour which is not available, 
the nearest value is used 
instead, so blue becomes 
black, yellow becomes white 
and so on. 

There are two types of 
colour, background colour 


Figure One: Stipple pattern numbers. 


and foreground colour (used 
for text). The background 
colour is selected by using 
the PAPER command, while 
the foreground colour is 
specified using the INK 
command, two rather nicely 
descriptive command 
names. So if we wished to 
have text in white ink on red 
paper background, we 
would use the commands 
PAPER 2 and INK 7, 

Specified like that, they 
refer to the area of the 
screen which is red when 
you start using the QL The 
screen is divided into three 
areas, or boxes, at first. 
These are referred to as 
windows’, a rather apt name 
for part of a glass screen! 


Channel 
Numbers 


Each ‘window has a num- 
ber which refers to it In com- 
mon with most graphics 
facilities, numbers are impor- 
tant here. The number which 
refers to-each window is 
called a ‘channel number 
and is normally written into 
colour and graphics com- 
mands by preceding it with 
a ‘hash’ character #. This is 


the Shift character above the 
number 3 on the English QL 
keyboard. 

This symbol tells us that 
the number which follows is 
a ‘channel number’, not a 
colour number, for example. 
The # symbol is important, 
since it can be omitted in 
many cases and the com- 
puter can only tell the differ- 
ence between a channel 
number and a colour num- 
ber when the # symbol is 
present. 

The three areas are 
referred to as channels 0, 1 
and 2. Channel O is the 
black part at the bottom of 
the screen. Channel 1 is the 
red part of the screen, and 
channel 2 can be blue 
when the QL is used in TV 
mode (Mode8) or white in 
monitor mode (Mode4). If the 
channel number is omitted 
in a command, the QL nor- 
mally assumes you are 
going to use channel #1. 
This is referred to as the 
‘default channel. 

PAPER 1 means use blue 
paper in channel number 1, 
while PAPER #2,1 means 
blue paper in channel 2. INK 
#1,7/ means white ink in 
channel 1, while INK 7 also 
means white ink in channel 
4s 


Channel CLS 


These commands start to 
become really useful when 
used with PRINT and CLS 
commands. When you use 
a CLS command to clear 
the screen, you can also use 
channel numbers to refer to 
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which part of the screen you 
wish to clear. CLS clears that 
part of the screen to the last 
colour specified in a PAPER 
statement. 

Therefore, PAPER #20 : 
CLS #2 makes the listing 
channel (window #2) clear 
to the colour black We can 


PAPER 0 


; INK 7 


So it can be used to high- 
light certain print statements, 
for example. The syntax is 
the same as the PAPER 
command. STRIP #0,4 


makes the printing to chan- 


nel #0 (normally the bottom 
of the screen) appear on a 
green background without 


: CES 


INPUT’Mode number (4/8)?’;mode_no 


MODE mode_no 
CLS 


FOR colour = O TO 255 
STRIP colour 


REMark 10 spaces in next line 
fe 


PRINT? 
STRIP Q 
' PRINT?’ 
PAUSE 50 
END FOR colour 


: REMark black 
Colour ’;colour 





Figure two: Print colour number examples. 


100 colour = 0O 


110 FOR size = 50 TO 0 STEP =-1 


120 
130 
140 END FOR size 


BORDER size,colour 
colour = colour + 1 





Figure three: Using BORDER to make patterns 


10 PAPER O : CES 


20 FOR y - 


0 TO 100 STEP 20 


FOR x = 0 TO 100 STEP 20 


BLOCK 20,20,x,y,RND(1 TO 7) 
PAUSE 5 
END FOR x 
50 END FOR y 





Figure four: BLOCK demonstration. 


use PAPER to set the back- 
ground colour for a print 
statement like this, although 
there is also another com- 
mand to help us with this. 


PAPER #2,0 

CLS #2 

PAPER #2,2 : INK #2,7 
PRINT"White on red” 


The STRIP command is 
like the PAPER command, 
but has no effect on the 
paper value used by CLS. 


affecting the colour of the 
whole window. When you 
use the PAPER command, it 
automatically makes the 
STRIP colour the same as 
the new PAPER colour until 
you change it. 

Although the QL has only 
eight basic colours, it is pos- 
sible to combine these 
colours in fine dots or lines 
to give the effect of further 
colour patterns, up to 256 in 
total. 
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Colour Spec 


You can give the INK and 
PAPER and STRIP com- 
mands two types of colour 
numbers. You can specify 
the value as a number from 
0 to 255, eg INK 255. You 
can also specify the colour 
value as three numbers indi- 
cating a colour, a contrast 
colour (not easy to explain 
without recourse to binary 
arithmetic) and a pattern 
number. The pattern number 
is a number from 0 to 3. 
Given a 2x2 block of colour, 
the values represent dots 
used as follows. Pattern 0 
means use one of the four 
dots, pattern 3 means use 
Opposite corners in the 
same colour, while 1 means 
horizontal strios of colour 
and 2 means vertical strips. 
These are best represented 
by a diagram, so see Figure 
one. The use of fine dots to 
create the illusion of extra 
colours is called Stippling. 
Colours created in this way 
are called Stipple Colours. 

We can express a black 
and white dotted colour as 
either a value of 255, or as 
the three numbers 7,0,3. At 
this stage, you have to find 
the colours by experiment or 
by looking at lists since 
there is no easy way to 
describe how they are made 
up and what each colour 
will look like. Figure two 
shows a simple program 
which runs through all 
colour values on the screen, 
showing the colours and 
what they look like. It asks 
you for a mode number, 
then lists all the colours as 
strios of colour, scrolling the 
slowly up the screen - the 
PAUSE 50 statement waits 
for one second between 
each one to give you a 
chance to look at them 
while they slowly appear. If 
you press a key on the key- 
board, the program will run a 
little faster if you wish. Or you 
can vary the value after 
PAUSE to change the speed 
reduce it to make it go 
faster, while increasing the 
value will make the program 
run slower. The value after 


pause works in units of 
1/50th second. 


BORDER 


It is also possible to 
change the colour of the 
frame around each window, 
or to have no frame at all. 
The BORDER command 
allows you to set the colour 
and size of the frame 
around each window, by 
specifying a channel num- 
ber (default value if omitted 
is #1 as before), size of the 
border and the colour value, 
which can be a single num- 
ber or three numbers as dis- 
cussed above. BORDER 
#2,1,4 puts a green border 
which is 1 dot high at the 
top and bottom (it is actually 
two dots wide at the edges 
for reasons we won't go into 
here) around window #2. 
You have to be careful to 
specify a size which will 
actually fit into the window, 
or the QL will give an error 
report! 

Figure three is a colourful 
example showing how to 
use the BORDER command 
to generate some pretty pat- 
terns by changing the size 
of the border. It looks best 
running in Mode8, but will 
also run in Mode4. It flashes 
a lot when running; be care- 
ful if you are prone to epilep- 
sy through visual distur- 
bances. 

It would be nice if we 
could place blocks of colour 
inside a window as well as 
writing text in colour. There 
is a command called 
BLOCK (surprise surprise!) to 
do this, but to use this we 
need to learn about pixels 
first. 


Pixels 


The screen picture is 
made up of hundreds of tiny 
dots or picture elements, 
called pixels. Each is just 
large enough to see on a 
good display monitor. Letters 
and graphics drawn on the 
screen are made up of com- 
binations of these little dots. 
In mode 4, there are 12 dots 


across the screen and 256 
downwards. In Mode8, there 
are only 256 dots across, 
which is why everything 
looks a bit more chunky in 
Mode8. Because there is 
twice the number of colours, 
half the number of dots are 
available in order to ensure 
that the computer uses the 
same amount of memory to 
keep the picture. 

The screen is always 
addressed as the number of 
dots across and down the 
screen, 0 to 511 across in 
both modes (to keep things 
equal to the programmer) 
and 0 to 255 down. The ori- 
gin is position 0,0 at the top 
left hand corner of the 
screen. 

Few QL commands use 
the absolute value across 
the screen. The BLOCK 
command uses the co-ordi- 
nates from the top left corner 
of the window it refers to, not 
from the top left corner of 
the screen. To place a block 
of colour on the screen we 
must specify the width and 
height, along with where in 
the window to place the 
block of colour, and the 
colour itself, which can be 
different to the ink and 
paper colours. 


BLOCK #channe 
| width,heightxy,colour 


The channel number can 
be omitted if required, in 
which case it refers to the 
default of channel #1. 
“width” is the size of the 
block (the maximum is 512 
in both modes, though it 
depends on the size of the 
window), “height is the num- 
ber of dots high (up to 256, 
although it depends on the 
size of the window). “x” and 
‘y’ are the distance from the 
top left corner of the window. 
Figure four helps to show 
how this works - it draws a 
block of random colour 
which is placed at progres- 
‘sively greater distances from 
the top left corner, first of all 
moving to the right, then 
going back to the left a little 
further down until it reaches 
the final position. 


Experiment a little with all 
of the values to see what 
effects you can get and see 


REMark alter #0, 


MODE 8 


DOW command to specify 


where an area of the screen 
is to be placed and what its 


#1 and #2 


the dimensions used to see 
how they affect the size and 
location of the window. 


REMark first clear the entire screen to black 
WINDOW 512,256,0,0 


PAPER O =: CLS 


WINDOW #0,448,42,32,16 


PAPER #0,4 


BORDER #0,1,2 


: INK #0,0 


sniCL6-. #0 


PRINT #0,’This is window #0’ 
WINDOW 448,82,32,70 


PAPER 2 : 
BORDER 1,255 


INK }-7 : 


CLS 


PRINT’This is window #1’ 
WINDOW #2,448,82,32,160 


PAPER #2,6 : 
BORDER #2,1,1 


INK #2,1 


ar€LS #2 


PRINT #2,’This is window #2’ 


Figure five: WINDOW demonstration. 


if you can work out how to 
draw a box around a piece 
of text, for example. (Hint: 
use the AT command to 
position some text and see 


if you can work out how 


many pixels it takes to be 
the same size as a piece of 
text and how you can make 
BLOCK locations match AT 
locations). 

It is very important to 
stress that although there 
are 256 pixels across the 
screen in Modeé8, the sys- 
tem requires you to pretend 
that there are 512 like 
Mode4, but odd values are 
rounded down to even val- 
ues, or odd values are 
ignored. In other words, in 
mode 8, 1 is the same as 0, 
3 is the same as 2 and so 
on. Values across should be 
multiples of 2 for both width 
and the location across. 


Moving 
Windows 


Having mastered the prin- 
ciple of co-ordinates and 
pixels, we can move on to 
windows themselves. It is 
possible to rearrange the 
areas of the screen - we can 
change their sizes, we can 
swap them about, we can 
move them to different 
places. We use the WIN- 





1000 DEFine PROCedure TV_WINDOWS 


1010 
1020 
1030 
1040 
1050 
1060 


CLS #0 
CLS #1 


CLS #2 


WINDOW #0,448,40,32,216 
WINDOW #1,448,200,32,16 


WINDOW #2,448,200,32,16 


1070 END DEFine TV_WINDOWS 
1080 DEFine PROCedure MONITOR_WINDOWS 


1090 
1100 
1118 
1120 
1130 
1140 
1150 END DEFine MONITOR_WINDOWS 


CLS #0 


WINDOW #0,512,50,0,206 


WINDOW #1,256,202,256,0 
BORDER #1,1,255 
WINDOW #2,256,202,0,0 
BORDER #2,1,255 : 


; €LS #7 


CLS #2 





Figure six: How to-restore original windows. 


size will be. 
WINDOW width,heightxy 


Where “width” is the num- 
ber of pixels across, “height” 
is the number of pixels 
down, “x” is the location 
across the screen and “y’ is 
the location down the 
screen. Again, “width” and “x” 
must be even values. 

Figure five shows how to 
rearrange the windows you 
get when the QL starts up 
into three horizontal sections 
one below the other. Vary 


Remember that the origin 
value (“x”) plus the width 
must not exceed 512 and 
the “y” origin value down 
plus the height must not 
exceed 256. 

Note how the channel 
numbers (preceded with #) 
can be used in PRINT state- 
ments and CLS statements 
to make them operate on 
selected parts of the screen. 


Restore All! 


Having reorganised our 
screen, we need to know 
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how to put it back together 
again! Figure six shows the 
statements needed to repo- 
sition the windows for televi- 
sion and monitor mode. 
These are two routines you 
can add to your own pro- 
grams. They are written as 
procedures - use the name 
TV_WINDOWS to restore 
television display sized win- 
dows and MONITOR_WIN- 
DOWS to restore the monitor 
display sized windows to 
cover most of the screen. 
These two routines are very 
useful for undoing whatever 
your program has done to 
the normal windows! lf 
required, add your own 
PAPER and INK commands 
to restore the colours as well 
as the size of the windows. 
You may have noticed that 
the commands to set up 
television mode windows 
use a smaller section of the 
screen than the monitor ver- 
sion. This is because some 
television sets cannot dis- 
play the full 512 pixels 





across the QL display, they 
tend to clip a little bit at the 
left and right of the picture, 
so the television mode win- 
dows deliberately get posi- 
tioned 32 pixels from the 
edge to make sure you can 
see them all. 

There are a couple of 
other useful commands 
which should be mentioned 
here too. If you are using the 
computer in Modeé8, it is 
possible to make printed 
text flash on and off, by 
using the FLASH command. 
FLASH 1 makes text flash, 
while FLASH O means that 
the next text written to the 
screen will not flash. Both 
can have channel numbers 
FLASH #0,1 turns on flash- 
ing in the bottom window. It 
does not work in Mode4. 

If you would like to be able 
to print text over a picture or 
without disturbing some 
areas of colour you have set 
up with BLOCK, there is a 
command to make printing 
ignore the paper colour. 


Unsurprisingly, the com- 
mand is called OVER and 
can have three values or 
states. OVER 0 is the normal 
setting, which means that 
text will be printed in the 
selected ink colour with the 
selected background paper 
or strip colour. OVER 1 
means ‘transparent’, or no 
strio colour is used. OVER -1 
gives a rather ghostly effect 
where printing is sometimes 
transparent or the colour 
does not come out as 
expected. Some binary arith- 
metic is again required to 
fully understand what goes 
on, but it does have one 
very useful function - if you 
print something again on 
top of itself, it makes the 
original disappear as long 
as colours did not change. 
This can be very useful 
when programming moving 
graphics on the screen, for 
example, although you will 
not encounter it much at 
first. Like other commands, 
OVER can take a window 


ARGHIIWE YOU 


GOLLEGIIOIN 


Now you can keep your Sinclair QL 
World magazines safe and clean. No 
more dog-eared covers or missing 
copies .. . You can protect your 
magazines in this high inicsh 
specially-created binder. This Sinclair 
QL World binder will comfortably hold 
a complete year’s issues of your 
favourite Sinclair magazine. It is a high 















ly, 


quality product, British-made and | 
comes with full binding instructions. It is 
manufactured in a rich, deep blue with | 
genuine gold blocked lettering. } 
Enhance your Sinclair QL World 
Magazine collection now for only 
£6.95 (inc.P&P!) Send for one today! 
The QL World binders also make an — 


ideal gift for other Sinclair users too! 


ra) 
®) 


channel number, defaulting 
to #1 if not specified. 

In the next issue, we will 
be developing our knowl- 
edge of QL graphics and 
printing. 
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QL-PC FiLF- 
SERVER 





A low-cost method of hooking PC hardware to the QL, described 


by user Jack Brown. 


INFORMATION 
Product QL-PC Fileserver 
Price: £2450 


Suppliers: Written by Di-Ren. 
Available from Dilwyn Jones 
Computing, 41 Bro Emrys, 
Bangor, Gwynedd LL57 3YT. Tel 
0248 354023. 


Serial link leads: From TF 
Services, 172 Bouverie Place, 
London W2 7RB. Tel 071 724 
9053. 


Wi -Ren, the manu- 
[> facturers of this 
: program, are not 
prolific, but when 


they do produce something for 





the QL | usually find it interesting. 


| cite, for instance, Fleet Tactical 
Command and QL Network 
Prover. 

| guess that most of us who 
have access to PCs have tried, 
or at least considered, the possi- 
bility of linking the PC and the 
QL In the past there have been 
a few articles on how this might 
be achieved but invariably these 
have only been suitable for 
occasional operations. At last 
someone has come up with the 
solution, 


PC hardware 


The QL-PC Fileserver is a pro- 
gram designed to give the QL 
direct access to a PC's hard- 
ware devices: disk drives, 


QL CONNECTIONS 


screen display and printer ports. 


When installed, the program 
essentially converts the PC into 
a fileserver for the QL From the 
QL user's point of view, once 
linked, the PC just looks like any 
other QL device. For instance, 
entering DIR PCDS3_ will display 
the PC's drive C: directory in the 
normal QL format. 

The program is full of useful 
features. Not only can you 
directly access any device DOS 
sees as a disk drive, be it floppy, 
ram or hard disks; you can also 
access the PC's screen display 


and, exceptionally, the PC's print- 


er ports. This last feature is very 
beneficial as it means | no 
longer have to swap printer 
leads or get myself a switch box 
to allow both machines to use 
the same printer. 

Another important feature of 


PC CONNECTIONS 


For QL Serial Port 2, swap QL pin connections 2 and 3, swap pins 4 and 5. 


DISCLAIMER 
No claim is made as to the suitability or accuracy of these instructions for any purpose. We do not accept liability for any damage to machinery or data that 
may occur in connection with the instructions contained herewith. 


the fileserver is its ability to 
access PC networks through 
the linked machine. It would 
appear that any device that DOS 
“sees” as a disk drive is also 
accessible by the QL To test 
this, | dragged the QL into work 
and tested it over our Novell net- 
work. It lived up to the authors’ 
claims, of course! 


Links 


Connection of the two 
machines is via the serial links. 
Di-Ren supply a serial pin-out 
table but, unless you have some 
knowledge of serial linking, it 
would probably be advisable to 
obtain a ready-made lead. These 
are available from TF Services. 

Having a suitable lead on 
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hand from my previous experi- 
mentation it was just a case of 

olugging it in and trying out the 
program. 

The PC part of the program 
arrived on both 5.25-in and 3.5- 
in formats and is in the form of a 
TSR (Terminate and Stay 
Resident program). The ability of 
the TSR to operate as a back- 
ground task is of particular sig- 
nificance. Not only does it look 
after the QL's interests, but also 
allows you to run PC software at 
the same time. 

Invoking the PC part of the 
orogram requires a short com- 
mand line in the context of 
QLNET /Comm port/Baud 
Rate/Default Drive/V2. Comm 
port is the Comm port number 
you are using to link the 
machines. Baud rate should be 
the highest baud rate common 
to both machines. Default drive 
is either a ram drive or your 
default disk drive (normally C). 
V2 is optionally invoked if you. 
require the program to be a 
stand-alone task. 

For instance, QLNET 
/COM1/9600/C: will invoke the 
TSR using Com to link the 
machines at a baud rate of 
9600. Drive C: is the pro- 
grammes working drive. 


The QL program 


The QL program arrived on a 
3.5-in DSDD disk Contact DUC if 
an MDV version is required. 

The program is loaded in the 
same way as any toolkit: LRE- 
SPR FLP1_NET_BIN (If you have 
TKIl), or locate—RESPR (6200). 
LBYTES FLP1_NET_BIN|ocate. 
CALL locate. This loads the 
toolkit. To invoke the fileserver 
first set the Baud rate and then 
enter PCSERVE Ser(?), where ? 
is the serial port number you will 
be using. A point to consider 
before starting the program is 
that TKIl’s command PRT_USE, 
must not be invoked to the seri- 
al port you are using to link the 
machines. This sets up outout 
buffering to the port and the file- 
server doesn't like it! Make sure 
that this command is not 


embodied in your boot files. 

Unlike many QL software 
manuals in my possession the 
fileserver instructions are 
refreshingly clear and concise. 
An explanation of each com- 
mand is given, as well as an 
example of correct usage. It's a 
pity more instruction manuals 
aren't written like this. There is 
nothing more infuriating than 
having to wade through reams 
of useless waffle only to find 
there is no specific example of 
the command in question. 


File handling 


Accessing files stored on PC 
disks is done in exactly the 
same way as native QL devices, 
Typing the command PCLIST 
returns the drives available. Two 
directory device drivers are 
available; PCD and PCX. Both 
are used in the normal QL style. 
For example, 
OPEN_NEW#10,PCD1_TEST_FI 
L, will open a new file on the 
PC's floppy drive A. PCD is the 
driver you would normally use. 
PCX automatically converts doc- 
ument newline codes for files 
you may wish to edit on either 
machine. Again, | have tested file 
operations with the well-used 
QL programs Quill, Abacus etc, 
and there are no problems. 
Another major plus for the pro- 
gram is its ability to recognise 
native QL files stores on the PC. 
This means that it is possible to 
EXEC QL programs direct from 
the PC. 

Subdirectories on the PC can 
be made and removed using 
the commands PCMD and 
PCRD. Subdirectory stepping is 
achieved by using TKll-style 
commands PCUP, PCDOWN 
and so on. It is also possible to 
manipulate the PC file 
read/write attrioutes directly 
from the QL 

Most standard and TKIl wild- 
card file-handling commands 
are accepted by the fileserver. 
You can for instance DIR, WDEL, 
WSTAT and so on. Not support- 
ed are FORMAT, RENAME and 
TRUNCATE. 
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Transfer speed 


The speed of data transfer is 
the program's only drawback. It 
is necessarily limited by the QL’s 
slow serial port handling capa- 
bilities and cannot be compared 
to loading from floppy or hard 
disks. However, since most 
Qdos files are quite compact 
(especially compared to PC files) 
this isn't a problem. 

After several tests | calculated 
an average transfer rate of 
around 750 characters per sec- 
ond. This is transferring data 
from the QL's ramdrive to the 
PC's (486) hard disk, with the 
baud rate set at 9600. If you 
have the 8049 replacement, 
Hermes, fitted, data transfer 
speed can be dramatically 
increased due to the ability of 
Hermes to transmit and receive 
at 19200bps. 

A point worth noting is that it 
appears to be far quicker trans- 
ferring from the QL’s ramdrives 
that from floppies or even 
worse, microcassettes. 

| now make a practice of 
copying files from the PC to the 
QL's ramdrive before manipula- 
tion. This is not only far more effi- 
cient, it also means there is a 
back-up copy should | make a 
mistake. 


The Drivers 


When the fileserver is invoked 
the QL has a new device driver 
“PSCR’. This opens a text win- 
dow on the PC's display (similar 
to the QL SCR device). It is a 
simple driver that supports 
PRINT, AT and CLS commands 
and is useful if you wish to view 
two pages of information at the 
same time. 

A much more useful feature is 
the device driver LPT. This . 
works in exactly the same way 
as sending printer data to the 
SER ports, except that data is 
actually presented to the PC's 
LPT ports. | have extensively test- 
ed this and it works perfectly. 
Output to the QL’s SER ports 
(including the port used to con- 
nect the two machines!) can be 


re-directed using the command 
PC_DEV, which means you don't 
have to re-configure your pro- 
grams. 

The combined PC and QL 
orogram package costs £24.50 
- not bad value for money. It is 
not only novel to be able to con- 
nect almost any QL and PC 
together in a useful manner, it is 
also a very economical way of 
directly accessing the PC's 
hardware, in particular its very 
large mass storage Capabilities. 

The program will run on all 
QLs, with or without toolkits, and 
PC-compatible XTs and ATs that 
are running a minimum DOS 
version of 2.2 (practically any 
modern PC, in other words). 

| have found the fileserver to 
be very useful. All my important 
QL files are now archived on the 
PC and the printer is perma- 
nently accessed through the file- 
server. No more fiddling! 


Serial Links 


Making up Serial link leads for 
UK QLs with BT-type 6-pin 
olugs is something of a tedious 
business without the assistance 
of a special termination tool. If 
you do make up your own 
leads, it is essential that you 
check out the finished product 
with a Multimeter or some other 
tyoe of circuit tester, and that the 
connections are correct, before 
using them. 

The following information is 
from Di-Ren’s Serial Link Pin-Out 
Table (Issue 3), which you can 
get with Fileserver in any case: 

25- and 9-pin connectors are 
normally numbered on the face 
of the plug. The UK-type BT plug 
used for the QL has Pin 6 near- 
est the latch. 

Pin 6 on the QL BT-type plugs, 
and pin 9 on QLs with 9-pin 
plugs, carry a 12-volt DC cur- 
rent from the QL Under no cir- 
cumstances should these pins 
be connected. Di-Ren’s connec- 
tion table is reoroduced as 
Figure one, but please note that 
connections vary slightly in dif- 
ferent countries, and you should 
do your best to check that the 
connections are correct. 


DIY TOOLKIT 


Simon Goodwin translates his DIY Mouse driver into interrupt-driven 
QOL machine code. 





n last month’s 
QL World | 
explained the 
messages sent 
by two types of wide- 
ly-available serial 


* QI WORLD DIY TOOLKIT - MOUSE/POINTER DRIVER 
* Links SuperBASIC to a 2 or 3 button PC serial mouse 
* Version 1.6, Copyright 1993 Simon N Goodwin 


mouse, and decoded # 

TOE ser_port equ 2 Configure to one or two 
the oe RB ais ser_pointer equ 148+ser_port*4 152 for SER1, 156 for SER2 
Hermes, Uperbasic buttons equ 2 Configure to two or three 
and the QL serial port. * 

This version : Configuration error trapping for DEVPAC etc. 

includes a machine- es seven 

code interrupt server ifne buttons-3 

which runs fifty times fail : Wrong number of buttons 
2 endc 

every second, trans ee 

lating incoming data * 

into co-ordinates and ifne ser_port-1 

button information cant ae Serial port 1 or 2 expected 

which can be manip- etite . : 

ulated from endc 


SuperBasic. “f . ave: . 
* Offsets of variables in interrupt linkage 
* 


= link equ 0 Interrupt link comes first 
Loading vector equ 4 Offset of code address 
marker equ 8 Offset of "DIY1" signature 
Listing One is the prefix equ | 12 
* 
assembly code, * These variables are relative to PREFIX 
developed and tested * 
with HiSoft’s Devpac latest_x equ @) Current co-ordinates 
latest_y equ 2 
Rag sitentad Type limit_x equ 4 Right margin limit 
IS elt eee plea limit_y equ 6 Top margin limit 
assembier IT You wan step_x equ 8 Counts per horizontal move 
a step_y equ 10 Counts per vertical move 
to TOG! cational butt bit LZ Bit had h butt 
button_bits equ its shadow eac utton 
ment with the source. synchro equ 14 iInpuc byte # #.:3 Gr i..5 
The only unusual fea- initial equ 15 Microsoft initial byte 
tures are the word serial_id equ 16 Zero or serial channel ID 
sizes after vector act on whl oat orbttivar end 
addresses like $E2.W —— ae 
(1O.QOUT) and start lea define,al 
$11A.W (BV.CHRIX). move .w $110.w,a2 BP.INIT vector 
2) 
Remove the second 7 ne Soa 
W if your assembler * PTR_ON asks is it already on? if so, return no error 
objects to these lines, a : y esis : 
point_on sr.s ind_pos 
oe ltl “oF i ian ee 
* 
assembly code are * Otherwise, allocate linkage area in common heap 
discussed, as usual : 
, . moveq #var_length,dl 
at the end of this arti- moveq #0,da2 Owned by SuperBASIC 
cle. moveg #24,a0 MT.ALCHP trap key 
Listing Two gener- trap #1 r ah 
ates code for the two- eee ae oe ee See 
button SER2 lea. server ,a2 
Microsoft serial 


mouse handler from 
Basic DATA state- 
ments at the end of 
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the listing. Type this in 
and run it to generate 
the MOUSE_CODE 
file. 


X=RESPR(650) 
LBYTES FLP1_ 
MOUSE_CODE,X 
CALL X 


This sequence of 
commands adds the 
extensions PTR_ON, 
PTR_OFF, PTR_POS, 
PTR_MAX, PTR_INC, 
PTR.LIMIT Ss 
SYNCH%, BUTTON%, 
X_PTR% and Y_PTR% 
to SuperBasic. If you 
don't like the identi- 
fiers you can patch 
their characters with 
utilities like Spy, The 
Editor or FEDIT, or re- 
assemble Listing One 
_ with completely new 
names at the end. For 
top compatability, 
load the standard 
names and use ALIAS 
from DIY Toolkit 
Volume A to set up 
your own alternatives. 

The DIY Toolkit 
mouse driver is 
included in the latest 
volume on disk, avail- 
able from Dr. Bill 
Fuggle. Volume | (I’m 
running out of alpha- 
bet) includes last 
month’s SuperBasic 
prototypes, wiring 
details, example pro- 
grams, assembler 
source and binary 
code for “Mouse 
systems PC” and 
“Microsoft” — serial 
mouse drivers to suit 
either serial port. 

DIY Toolkit volumes 
cost three pounds 
each on disk or 
microdrive cartridge, 
and come with print- 
ed documentation if 
you order two or 
more. Twenty five vol- 
umes are available from 
DIY Toolkit, 86 Lordswood 
Road, Harborne, 
Birmingham B17 9BY. Send 
a stamped self-addressed 
envelope if you would like 
further details. 


move. 
move. 
move. 
move. 
move. 


bt 


* 


a2,vector(a0) Provide code address 
d7,marker(a0) Add signature 
#$1FFOOFF,prefix+limit_x(a0) * 511, 255 


#S6000A,prefixt+step_x(a0) 


a0 ,a6 


* See if serial channel is open 


* 
moveq 
trap 
tst. 1 


bne.s 
* 


lea.l 
moveq 
moveq 
moveq 
trap 
tst.l 
bne.s 
movea.1 
move.1l 

Link 2¢t movea.1 
moveg 

trapi_out trap 

it_worked moveq 
rts 

* 

no_input move.1 
move.l 
moveg 
trap 
move.1 
rts 

x 

find_pos2 bsr.s 

oops rts 

* 

point_off bsr.s 
bmi.s 
move.1 
beq.s 
movea.1 
moveg 


trap 
* 


#0,d0 MT. INF 
#1 


a G, wal 


ser_pointer(a0) Is SER input queue open? 
Link it Nearly finished 


* If not, take note & open it; assume correct baud rate 


stream,a0 Point at channel name 
#0,da1 Permanent ownership 
#1,da3 OPEN_IN 

#1,a0 IO.OPEN trap key 

#2 

do 

no_input 

d6,al 


a0,prefix+serial_id(al) 


d6,a0 Restore AO, link address 
#28,d0 Set up MT.LPOLL trap key 
#1 

#0,da0 

d6,a0 Deallocate the heap space 
do ,da7 

#25,d0 MT.RECHP trap key 

#1 

a7 ,do Return OPEN error code 
find_pos Extra call allows trapping 
find_pos2 Is our interrupt linked? 
no_error If not, return at once 
Serial_id(a4),d0 

not_opened No need to close it 

do,ao 

#2,a0 IO.CLOSE trap key 

#2 


* Remove interrupt server and deallocate linkage memory 


* 


not_opened lea.l 
moveq 
trap 
moveq 


bra.s 
* 


~prefix(a4),a0 


#29 ,da0 MT.RPOLL trap key 
#1 

#25,d0 MT.RECHP trap key 
trapl_out 


* BUTTON%(x%) reads buttons and returns a code 0 to 7 (+) 


* 

button movea.w 
jsr 
bne.s 
subg.w 
bne.s 
move .w 


Mouse Calls 


Before you can use the 
mouse you must issue two 
commands - one to tell the 
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$112.w,a2 Vector gets words 

(a2) 

bad_exit 

#1,a3 Ensure just one parameter 
bad_param Reject otherwise 


O0(al,a6.1),d3 


serial ports the baud rate 
and one to start the inter- 
rupt server. It is not neces- 
sary to open the serial port, 
as the handler will do this 
automatically if it is not 
already open. 


Normal QLs support only 
one RS-232 speed or ‘baud 
rate’ at a time - this should 
be 1200 baud for a PC seri- 
al mouse. If the wrong baud 
rate is selected the mouse 
will work erratically or not at 


all. If you can't get the 
mouse to work, the 
baud rate is probably 
not set correctly. To get 
underway, use these 
commands: 


BAUD 1200 

PTR_ON 

The Hermes 
upgrade from TF 


Services makes the 
serial ports much more 
reliable, among other 
tricks, and allows sep- 
arate baud rates for 
each port. This means 
you can use a-9600 
baud printer or 
modem at the same 
time as a 1200 baud 
serial mouse, but in 
such a case the BAUD 
command should not 
be used as that affects 
both ports. Set up your 
other port as normal, 
load the Hermes 
Toolkit, then enter: 


t-RXBAUD%(1 96) 
PTR_ON 


to use a mouse with 
SER2, or: 


t-RXBAUD%(68) 
PTR_ON 


to allow 1200 baud 
input from SER1 with- 
out affecting the other 
serial data streams. 


Keywords 


The keywords are 
the same as those for 
the Amiga Qdos point- 
er driver, so that pro- 
grams that work with 
one will suit the other, 
although the Amiga 
mouse hardware is very 
different from that of a ser- 
lal mouse. 

You can read the co-ordi- 
nates from SuperBasic, set 
limits, and move the pointer 
to a desired integer co-ordi- 
nate. Amiga allows co-ordi- 
nates less than zero but the 
DIY Toolkit extensions only 
use positive co-ordinates, to 
a maximum of 32767. 

The DIY Toolkit imple- 


* 


* Put the state of all the buttons into DO; bit 0 = Button 1 


* 


read_all bsr.s 
move .W 
beq. 
ts 
beq. 
cmp. 
bhi. 
subq.w 
btst 
bne.s 
moveq 
bra.s 


H=enen 


main_line 


* 


find_pos 


button_bits(a4),d4 Check up to 16 buttons 


ret_integer 
a3 
ret_integer 
#3,da3 
bad_param 
#1,da3 

da3,d4 
ret_integer 
#0,a4 
ret_integer 


None so parameter irrelevant 


Parameter 0, no filtering 


Number bits from 0 
If choice set, return ail 


Stack space is allocated 


* SYNCH needs just four lines and ten bytes of code 


* 
synch bsr.s 
moveqd 
move.b 


bra.s 
* 


find_pos 

#0,d4 
synchro(a4) ,da4 
chk_integer 


* XPOINT% and YPOINT% differ only in the offset they use 


* 


xpoint moveqg 
bra.s 

ypoint moveg 

get_word bsr.s 
move .W 


* 


* Return the integer 


* 
chk_integer moveq 
move.w 
jsr 
subq.1 
ret_integer move.1l 
move .w 
moveqg 
moveq 
rts 


no_error 


* 


#latest_x,d5 
get_word 
#latest_y,d5 
find_pos 
0(a4,da5.1),da4 


Read co-ordinate variable 


in D4.W to SuperBASIC via the RI stack 


Number of bytes needed 
Find the BV.CHRIX vector 


#2,al 

$11A.w,a2 

(a2) Allocate RI space 
#2,$958(a6) Update BV.RIP 


$58(a6),al 
da4,0(al,a6.1) 
#3,0a4 

#0,da0 


Type = 


Get BV.RIP 

Stack the result 

16 bit Integer 
No run-time error 


* FIND POS - point A4 at the parameters in the interrupt list 


* 
find_pos moveq 
trap 
move.l 
lea.1l 
move.l 
beq.s 
movea,1 
cmp.1 
bne.s 
lea.l 
rts 


find_loop 


found_it 


* 


not_found addq.1l 
moveg 
rts 

* 
bad_param 


bad_exit 


moveq 
rts 


mentation adds a function 
to read the buttons. Amiga 
Qdos converts their signals 
into key-codes, SO you can- 
not tell if more than one 
button is pressed. BUT- 
TON% removes this restric- 
tion. It takes one parameter, 
like its namesake in SAM 
Basic; zero reads all the 
buttons, and other values 


#0,a0 MT.INF 


#1 

¥° DIV" , a7 
60(a0) ,a4 
(a4) ,da0 
not_found 
do,a4 
marker(a4) ,da7 
find_loop 
prefix(a4),a4 


#4,a7 
#-7,a0 


#-15,da0 


read buttons one, two or 
three (hardware permitting) 
independently. 

If you have a three button 
mouse, BUTTON %(0) 
returns a value from zero to 
seven, with one bit corre- 
sponding to each button. 
For instance the value 5 is 
101 in binary, indicating that 
the outer buttons are both 


Locate polled list 
Pass error to prior caller 
Check signature 


Point at the data 


Discard one return address 


BAD PARAMETER error 


pressed and the middle 
button is not. 

The binary digits tally with 
the buttons from left to right, 
with the tail of the mouse 
stretching away from the 
user, sO button 3 is the left- 
most, indicated by the most 
significant bit. BUTTON%(0) 
returns a value of four, or 
more depending on the 
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other buttons, if the third 
button is pressed. 

If you find the combina- 
tions confusing, it is easy to 
test the buttons individually. 
BUTTON%(3) would return 
zero unless the button was 
pressed; similarly BUT- 
TON%(1) and BUTTON%(2) 
read the others, indepen- 
dently. In fact the code can 
cope with up to sixteen but- 
tons, so it may be adapted 
for use with serial digitisers 
and other devices fes- 
tooned with auxiliary switch- 
es. If you need more but- 
tons you'll need to change 
the ‘mask’ applied to the 
first byte of each message 
from the mouse to let more 
bits through. 


X and Y Limits . 


The two main functions 
are PTR_X% and PTR_Y%, 
which return the current 
position of the mouse, 
updated as it moves. 
PTR_MAX sets the limits for 
X and Y values - the default 
is PTR_MAX 511,255 so that 
co-ordinates correspond to 


Moded4 pixels. 
The Amiga has a four- 
parameter command, 


PTR_LIMITS, to set minima 
and maxima in each 
dimension. For compatabili- 
ty with compiled tasks that 
use PTR_LIMITS, the DIY 
driver recognises the com- 
mand, but the first two para- 
meters are ignored and 
should be zero for com- 
patability. Only the last two 
parameters are used - the 
code just discards the first 
two, checks there’s some- 
thing left, and continues 
through PTR_MAX. 

The co-ordinates are reset 
to zero by PTR_OFF fol- 
lowed by PTR_ON, so you 
may need a PTR_POS com- 
mand after PTR_ON if you 
do not want the pointer to 
Start in the corner. You can 
change the default by 
adding a line to set LAT- 
EST_X and LATEST_Y 
appropriately in the code 
after POINT_ON which ini- 
tialises the other variables 
like STEP and LIMIT_X. 


REMark Sinclair QL World HEX LOADER v 3 
REMark by Marcus Jeffery & Simon N Goodwin 


CLS: RESTORE 
PRINT "Loading Hex..." 


>: READ space: 


INPUT "Save to file...";£5 


SBYTES f£$,start,byte :; 


STOP 


DEFine FuNction DECIMAL(x) 


RETurn CODE(hS$(x) )-48-7*(h$(x)>"9") _ 


END DEFine DECIMAL 


DEFine PROCedure HEX_LOAD(start) 


byte = 0 


: checksum = 0 


REPeat load_hex_digits 


READ h$ 
IF h$="«x" ; 


EXIT load_hex_digits 


IF LEN(h$) MOD 2 
PRINT"Odd number of hex digits in: ";h$ 


1 TO LEN(h$) STEP 2 
DECIMAL (b) 


start=ALCHP (space) 
: HEX_LOAD start 


: lb = DECIMAL(b+1) 


TF hb<0O OR hb>15 OR 1b<0O OR 1b>15 


PRINT"Tllegal hex digit in: 


END IF 
POKE start+byte,16*hb+lb 
checksum = checksum + 16*hb + 1b 


byte 


= byte + 1 


END FOR b 
END REPeat load_hex_digits 


READ . check 


IF check <> checksum 
PRINT "Checksum incorrect. Recheck data.":STOP 


END IF 


PRINT "Checksum correct, data entered at: 


END DEFine HEX_LOAD 


"hs 


: STOP 


"estart 


REMark Space requirements for the machine code 
DATA 650 


PTR_INC sets the number 
of mouse pulses that corre- 
spond to one character- 
move in either direction. It is 
intended for the next ver- 
sion of the DIY Mouse dri- 
ver, which will send cursor- 
control characters to tasks 
normally controlled from the 
keyboard. The increment is 
in Mode 4 pixels, and starts 
off at six in X and ten in Y, 
Suitable for Modeé4 text in 
CSIZE 0,0 and CSIZE 3,1. 

If you use Mode or wider 
characters the cursor will 
respond much faster to hor- 
izontal moves than to verti- 
cal ones, and it may be 
worth increasing the X 
increment, with a command 
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like PTR_INC 12,10. It pays 
to experiment - some peo- 
ple like slower vertical 
movement since it reduces 
the risk of moving off the 
current line when scanning 
left and right. | 

You can use PTR_INC to 
scale the movement on 
screen to suit your mouse- 
pad. Staying in Mode for 
the time being, Try PTR_INC 
30,25 for easy character- 
positioning, and PTR_INC 
6,9 if you want faster move- 
ment. Double the first value, 
the X increment, if using 
Mode4, and double the 
second value to suit dou- 
ble-height characters. 

So far PTR_INC is dor- 





mant, as this version of the 
mouse driver does not use 
tee A_SIt rand \-orce 
variables. Notice that almost 
all the code it uses is 
shared with PTR_POS, 
PTR_LIMITS and PTR_MAX. 
The only difference is the 
offset of the stored parame- 
ters in the variable area. 


Where am I? 


The mouse driver does 
not display a pointer itself, 
as this could be over-writ- 
ten at any time by other 
screen output, and the 
code to intercept every 
access and update the 
pointer would be long and 


tricky. In many cases this is 
unnecessary as the position 
of the cursor, bat or highlight 
indicates the current location 
on screen, and this can be 
updated by the main pro- 
gram. 

The SuperBasic in Action 
Mouse Organ used the 
Amiga’s hardware sprite 
pointer. QL SuperBasic pro- 
grammers can use BLOCK, 
POINT, LINE or CURSOR 
with PRINT to position a 
marker on the screen, as | 
showed in last month’s 
SuperBasic examples. 

Note that vertical co-ordi- 
nate zero is the top of the 
screen, and moving the 
mouse down increases the © 
co-ordinate. This suits 
BLOCK and PLOT, but is the 
opposite way round from the 
graphics co-ordinate 
scheme, which starts with 
line zero at the bottom of the 
window. To reverse the Y co- 
ordinate, use CHAN_W% 
from DIY Toolkit volume C to 
read the window height in 
pixels: 


610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


"43FA021834780110","4ED2616267507220" 
"740070184E414A80","665645FA012C214A" 
"000421470008217C", "01FFOOFF0010217C". 
"0006000A00142C08","70004E414AA8009C" 
"661641FA01CE7200","760170014E424A80" 
"661022462348001C","2046701C4E417000" 
nteeeee FO2H0070191 , (484120074E75612A" 
i Ud a , '0010670620407002" 
4E4241ECFFF4701D","4E41701960CE3478" 
"01124E92667C5343","66763631E800614A" 
"382C000C67364A43","6732B67C00036260" 
"5343070466267800" , "6022612E7800182C" 
, DO0E600C7A006002" ,7A02611E38345800" 
72023478011A4E92","55AE0058226E0058" 
"3384E80078037000","4E7570004E412E3C" 
"4449593149E8003C" ,"2014670E2840BEAC" 
"O00866F449ECO00C", "4E75588F70F94E75" 
"70F14E7561D4508C" , "601047EBO0010BBCB" 
"62EE61C6588C6002" ,"61C0347801124E92" 
"66E0554366DA3231","E8006BD448413231" 
"E8026BCC28814E75","202E009C67F82440" 
"327800E249EB0014","4E9166EA74001401" 
"522CO00E102COO0E","72COB03C0002672C" 
"6A661942000FC401","B401662A7030C02C" 
"OOOFEA4864040000","00023940000C60C8" 
"197C0001000E1942", "O00F60E0C202B23C" 
"0080670864EA422C" ,"0Q0E60AC0202003F" 
"7203C22COOOFED49","82424881302C0000" 
"D0416B10322C0004","B041630230013940" 
"00006084424060F6","C202B23C00806704" 
"64AE60C20202003F","720CC22COO0FE949" 
"82424881302C0002","D0416B10322C0006" 
"B041630230013940","0002609A426C0002" 
"6094000653455232","49520006FE560750" 
"54525F4F4646FDE4","065054525F4F4E00" 
"075054525F504F59" , "FEDAO75054525F 4D" 
4525F4 
980 DATA "4158FEC207505452",,"5F494E4300000004" 
990 DATA "FE64065054525F58","2500FE5E06505452" 
1000 DATA ."5F592500FE1A0742" ,"5554544F4E25FE3C" 
1010 DATA "0653594E43482500","0000","*", 50246 


REPeat dots : POINT 
PTR_X%, CHAN_ 
W%(#1 ,30)-1-PTR_Y% 


The POINT command 
does not report an error if 
asked to plot outside the 
window. The SCALE and 
PTR_MAX commands can 
make the mouse co-ordinate 
range an exact fit for your 
graphics window. 





Buffering 


| tested this code with a 
standard 128K QL, Gold 
Card, Sinclair JM Qdos, 
Hermes and Sinclairs version 
0.7 IPC, and various Minervae. 
| concentrated on the tricky 
Sinclair hardware, as other 
Qdos machines have ‘proper 
serial ports with dedicated 
control chips which are much 
less likely to lose data. 

There is a small delay 
between the mouse sending 
information and the co-ordi- 
nate variables being updated. 
In extreme cases the buffers 
may be filled and some mes- 
sages may be ignored, but 


this is unlikely to be a prob- 
lem unless the machine’s 
attention is diverted for a 
long time by an operation 
like LBYTES or FORMAT. 
The mouse driver takes 
steps to re-synchronise itself 
if buffers overflow. Since last 
month | have found out 
more about the format of the 
two-button Microsoft mouse 
messages. It turns out that 
they have an eight bit resolu- 
tion in X and Y, but the bits 
are split between three bytes. 
This means that the first two 
bits of each byte can be 
used to identify the position 


in the message. 

The first byte starts with 
two Set bits, followed by a bit 
for each button, and two bits 
each to signal X and Y 
movement. These are the 
most-significant bits of the 
signed values in the next 
two bytes, which always start 
with one set and one reset 
bit. To find the full change in 
X, move bits 0 and 1 of the 
first byte into bits 6 and 7 of 
the second. Likewise bits 2 
and 3 of the first byte slot 
into bits 6 and 7 of the third, 
Y byte, which are initially 1 
and 0. 


Last month’s SuperBasic 
demonstration only used the 
six least significant bits. The 
new code uses all eight, so it 
can handle bigger changes 


IN one message. Byte values 


are signed, so bytes over 
127 correspond to their 
unsigned value minus 256. 
The code can re-sequence 
itself, rejecting bytes without 
the top bit set and treating 
bytes which start 11 as the 
first in a Sequence. 

At any time the QL's Intel 
8049 second processor can 
store up to 23 characters en 
route from either serial port 
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to the main processor; Qdos 
maintains a second queue 
for up to 80 bytes. The DIY 
code seems to track the 
mouse fairly well with a 
Sinclair IPC and JM Qdos, 
but button changes can get 
lost if the button is pressed 
while the mouse is moving 
fast. 

Hermes expands the sec- 
ond processor buffer to 31 
characters, and solves most 
problems of ‘serial over-run’ 
where the 8049 loses its 
place in the buffer. It works 
perfectly with this mouse dri- 
ver, and is warmly recom- 
mended for serial mouse 
USES. 

The debugging function 
SYNCH% indicates which 
byte of the mouse message 
is due next. It starts with zero, 
and increments by one after 
each byte, so it gives two 
when a Y delta is expected. 
lf bytes are corrupted or lost, 
SYNCH% is reset to zero, 
ready for a new and com- 
plete message. I've found 
SYNCH% useful in testing 
and it only needs ten bytes 
of code. 


Assembler list 


Listing One is the first half 
of the assembly code for the 
DIY Mouse. It includes rou- 
tines to create and delete 
the mouse interrupt handler 
and variables. This is more 
complicated than the typical 
DIY Toolkit extensions, so it 
uses advanced assembler 
features like conditional 
assembly, introduced in the 
HPDUMP routines earlier this 
year. 

You can configure the 
source for either SER1 or 
SER2, but the code must be- 
reassembled to take 
account of the correct queue 
address. It is not enough to 
change the text in the file 
from “SERZ2IR” to “SER1IR” or 
vice versa. 

Two equates at the start of 
Listing One control the port 
and mouse protocol. Set 
SER_PORT to one or two, 
and BUTTONS to two or 
three, depending to suit your 
mouse and cable, then re- 


assemble the code to make 
a custom version. The DIY 
Toolkit disk volume includes 
all the variations, ready 
assembled. 

The subsequent IFNE and 
ENDC directives ensure that 
an error occurs if the vari- 
ables are set incorrectly. It's 
worth doing this if your 
assembler can _ cope, 
because it much reduces 
the risk of creating an invalid 
file. Devpac reports a ‘user 
error if called upon to 
assemble a FAIL directive; 
other assemblers may see it 
as an incorrect opcode. The 
comment after FAIL identifies 
the exact error. 

DIY Mouse keeps ten val- 
ues and an interrupt linkage 
in the common heap. The 
next set of EQUates give 
names for offsets in this area, 
making the source more 
readable and reliable. You 
can add more variables, for 
lower limits or extra details, 
by incrementing 
VAR_LENGTH and adding 
new offsets after SERIAL_ID. | 
shall discuss the variables in 
more detail next month. - 

PTR_ON and PTR_OFF 
come first. The serial channel 
is only closed by PTR_OFF if 
it was opened by PTR_ON. 
There is no code to set the 
baud rate as MI.BAUD 
might upset Hermes. It's bet- 
ter to use SuperBasic to set 
the exact speeds you want 
for each stream. 


Rommable 


This interrupt handler will 
run from rom, unlike the DIY 
Toolkit timer routines in 
Volume H. The mouse driver 
keeps its variables in com- 
mon heap memory, and 
locates them when neces- 
sary by searching the inter- 
rupt list, looking for a charac- 
teristic ‘signature’ - in this 
case, “DIY1” - after each link- 
age. 

This would slow down the 
timer routines, as the search 
must be performed when 
each extension is called, but 
| may change the timers to 
work that way if | produce a 
DIY Toolkit rom. For now you 
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can see the required code in 
the listing, and adapt it if you 
need to write your own rom- 
mable interrupt handler. 

All SuperBasic extensions 
call the FIND_POS subrou- 
tine, which returns directly 
with a ‘not found’ error if the 
end of the list is reached 
and no signature is found. 
To prevent this error, tum on 
the interrupt handler with the 
PTR_ON command. Initially 
the pointer handler is loaded 
but not active; after PTR_ON 
you can turn it off at any time 
with the PTR_OFF com- 
mand. | 

The interrupt handler takes 
very little CPU time, even if 
there are several bytes to be 
processed, but it is conve- 
nient to be able to remove it 
completely, releasing the ser- 
ial port and discarding the 
variables in the common 
heap. 

Repeated calls to PTR_ON 
or PTR_OFF do not generate 
an error. If the required serial 
port is not open when 
PTR_ON is executed, the 
code opens the channel, 
and it normally remains 
open till PTR_OFF closes it. If 
the channel should close 
unexpectedly the interrupt 
server notices and returns 
quickly without taking any 
action. 

You are welcome to open 
the serial port before calling 
PTR_ON. In this case the 
server will ‘steal’ bytes from 
the serial input queue as 
they arrive. 

It is much more efficient to 
read bytes directly from the 
queue with the 1O.QOUT 
vector than it is to read them 
from the device with TRAP 
#3 calls. This is easy to 
arrange as two Qdos system 
variables point to the serial 
inout queues whenever they 
are active. The long words at 
offsets 152 and 156 hold the 
addresses of the queues for 
SER1 and SER2 respectively, 
or zero when not in use. 

The functions PTR_X%, 
PTR_Y% and BUTTON% 
read DIY Mouse variables 
and return their values to 
SuperBasic. Notice that BUT- 
TON% skips the potentially 


slow call to BV.CHRIX, return- 
ing an integer result in the 
space previously occupied 
by its parameter. 

Next issue the listing will 
continue with the remaining 
SuperBasic extension rou- 
tines, and source for the 
interrupt handlers that read 
serial bytes and adjust LAT- 
EST_X, LATEST_Y and BUT- 
TON_BITS accordingly. 


Multipointing 


The QL has two serial 
ports but | only own one seri- 
al mouse, so | have not 
experimented with ‘multi- 
pointing’ - my buzzword for 
the use of more than one 
mouse at a time. The device 
name is configurable to 
SER1 or SER2, and you can 
run two interrupt servers at 
once, as long as the identi- 
fiers are different, but | sus- 
pect that even the mighty 
Hermes might have trouble 
coping with two asynchro- 
nous streams of mouse- 
droppings at once. 

The pointer limits are glob- 
al, rather than local to each 
task, so it is wise to stick to 
the defaults if you want to 
use several pointer-reading 
tasks at once. A clever tasks 
could monitor SV_KEYQ and 
reset PTR_MAX to suit itself 
whenever its Cursor was re- 
selected. 

The DIY serial mouse dri- 
ver should run alongside the 
one built-in to the Amiga 
Qdos emulator, but the com- 
mands and co-ordinate 
functions would have to be 
renamed to avoid a clash 
with the Amiga system 
extensions; the device name 
should be “SER1IR” as stan- 
dard Amiga systems have 
only one serial port. 

| welcome reports from 
anyone who tries this, and 
I'm even more interested to 
know why they need to be. 
able to point in four dimen- 
sions at once. | might try to 
develop a four-note version 
of the Amiga Mouse Organ, 
but I’m not sure I'd be able 
to play it once the code 
was running! As ever, | wel- 
come your comments. 





Beg 
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Machine Code 





Finally, in Part 6 Alan Bridewell begins to turn machine code to practical use. 


ne of the 

biggest prob- 

lems that con- 

fronts would-be 
machine code programmers 
is this: its all very well mov- 
ing numbers around and 
getting them to do very sim- 
ple jobs, but how do we do 
the more complicated - and 
usually more necessary - 
jobs? For example, almost 
any worthwhile program will 
need to open channels, 
write text to the screen and 
to the printer, and be able to 
accept data from the key- 
board, regardless of what 
the ultimate purpose of the 
program is. And if you want 
a half-decent screen display 
you will also need to alter 
ink and paper colours, resize 
the characters, and draw 
interesting designs on the 
screen. 


Text to window 


Let us consider, for a few 
moments, just one of these 
problems in a more detail. 
Suppose we already have a 
suitable window opened 
(SuperBasic has three as 
soon as the QL is switched 
On, so it’s a reasonable 
assumption), and we wish to 
produce a program which 
will write some text into the 
window. 

We already know that 
each word in the screen 
ram is translated by the QL 
into a row of different 
coloured pixel dots (four 
dots in eight-colour mode, 
and eight dots in four-colour 
mode). So clearly a single 
character may need only 
part of a word, or more than 


one word, in a 
row, depend- 
ing on how 
wide the char- 
acter will be. It 
will, of Course 
have to occu- 
py several 
rows of dots; 
how many, 
will depend 
on how high 
the character 
is. SO work- 
ing out how 
to print a sin- 
gle character 
of a required 
width and 
height at a 
particular 
location on : 
the screen, 
with a partic- ‘ 
ular ink and 
paper colour 
would 
appear to be 
a pretty for- 
midable task 
- and we 
haven't con- 
sidered flash- 
ing charac- 
ters yet! 
Fortunately, 
we have a 
major short- 
cut, and an 
obvious one if you think 
about it. AS soon as you 
switch on your QL, you can 
press any character key on 
the keyboard, and, (surprise, 
surprise) that character 
appears in window #0 on 
the screen. This can mean 
only one thing: the code 
needed to solve the prob- 
lem of printing characters on 
the screen already exists in 
the rom of the QL. All we 


; THE ROU 


OPEN A CON CHANNEL 


5 
+ SSSSCSSSSSSK ESS SCCSSSCTSSSSSSSCCSKSSESSSSESSE SSS SESSESESCSSSSesernesesesseaesess 
> 


TINE EXPECTS THE SUPERBASIC CALL TO PLACE IN:- 
D1 BORDER COLOUR & WIDTH 
D2 PAPER & INK COLOUR 


D3 WINDOW WIDTH 


D4 WINDOW HEIGHT 


DS X ORIGIN 
D6 Y ORIGIN 


MOVE.W 
MOVE.W 


D1,(Al)+ 
D2,(Al)+ 


; BORDER COLOUR/WIDTH IN CON TABLE 
; PAPER & INK COLOUR IN CON TABLE 


MOVE.W 
MOVE.W 
MOVE.W 
MOVE.W 


D3,(A1)+ 


D5,(A1l)+ 
D6,(A1)+ 


; WIDTH IN CON TABLE 
D4,(Al)+ ; HEIGHT IN CON TABLE 
; X ORIGIN IN CON TABLE 
; Y ORIGIN IN CON TABLE 


LEA.L 
MOVE.W 
JSR 
CMPI.W 
BEQ.S 


MOVE.W 
JSR 
MOVEQ 
RTS 
MOVE.L 


CON,Al1 
$C6,A2 
(A2) 
#$99,D9 
STORE 


$CA,A2 


‘(A2) 


#3$2,D9 


Ag,(Al1) 


; RESTORE TABLE POINTER 

; UT_CON VECTOR IN A2 
; OPEN CONSOLE CHANNEL 

; IS THERE AN ERROR ? 

; IF NOT MISS OUT ERROR MESSAGE 
; OTHERWISE WRITE ERROR MESSAGE 
; IN #9 AND RETURN TO SUPERBASIC 
; PROGRAM 

; UT_ERR@ VECTOR IN A2 
; WRITE ERROR MESSAGE IN #9 
; NO ERROR RETURN 


; STORE CHANNEL ID 


+ S88 Seeeeeeseteaaas SSSSSSSSSSSSSSSSSSSSSSSSSSsSsessseseessesesseseseeseseees 


WRITE TEXT IN CON WINDOW 


MOVE.L (A1),A@ 
LEA.L TEXT,Al 
MOVE.W $D9,A2 


JSR (A2) 


; CHANNEL ID IN A@ 
; BASE OF TEXT IN Al 
; UT.MTEXT VECTOR IN A2 
; PRINT TEXT 


RTS ; RETURN TO SUPERBASIC 


; SPACE RESERVED FOR CHANNEL PARAMETERS 


DC.W 
DC.W 
DC.W 
DC.W 
DC.W 


$9969 
$0990 
$0999 
$0090 
$9999 


:; SPACE RESERVED FOR CHANNEL I.D. 


TEXT TO BE WRITTEN IN THE WINDOW 


"THIS IS A MESSAGE " 


need to do is to use that 
code in our own programs. 


Using QL code 


lf we can discover how to 
access the code used by 
SuperBasic, we can do any- 
thing in our machine code 
programs that can be done 
in SuperBasic. (Actually, we 
can do more than that. 


; PAPER & INK COLOUR 
; WIDTH 

; HEIGHT 

; X ORIGIN 

; Y ORIGIN 


; CHARACTERS 





There are routines in the QL 
rom which cannot be used 
directly from SuperBasic, but 
we can still use them in our 
machine code programs.) 
Only if you wish to do some- 
thing exceptional do you 
have to produce your own 
complex code. For example, 
the authors of Lightning and 
Minerva have rewritten rom 
routines in order to improve 
them. Now, that is the job for 
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Listing two 


166 z=RESPR(256) 


119 LBYTES flp2_LISTING1_code,z 


128 REPeat loop 


13@ PRINT#@,"Open channel and write text? (Y/N) " 


149 n = CODE(INKEY$(-1)) 
15@ SELect ON n 


166 = 89,121: open_and_write:NEXT loop 


176 = 78,119: STOP 
186 = REMAINDER 
198 END REPeat loop 


29% DEFine PROCedure open_and_write 


218 CLS 


22% INPUT,"BORDER COLOUR? ";border_colour% 
236 INPUT,"BORDER WIDTH? ";border_width% 


249 INPUT,"PAPER COLOUR? *;paper% 


259 INPUT,"INK COLOUR? ";ink% 


269 INPUT,"WINDOW WIDTH? ";width% 


279 INPUT,"WINDOW HEIGHT? ";height% 


289 INPUT,"X ORIGIN? ";x% 
299 INPUT,"Y ORIGIN? “;y% 


30% CALL z,border_colour%*256+border_width%,paper%*256+ink%, width%, height%,x%,y% 


31% END DEFine 


an expert! 

Even jobs like writing 
other characters not in the 
standard set is not really a 
major task. If you wish to 
work out how to write to your 
screen in Arabic, Chinese, 
Cyrillic, Hebrew, Greek, or 
any other non-Roman char- 
acters, basically, you simply 
have to tell the QL to access 
your special font rather than 
the standard one in the rom. 
The biggest problem is 
designing all the character 
fonts, and then working out 
how to keep all the bits of 
sticky paper on the keys to 
tell you which key prints 
which character! 

So, how do you find out 
about these routines in the 
rom? Various authors have 
published this information. 
Which source suits you is 
probably a matter of taste. 
You could try QL Technical 
Guide by Tony Tebby and 
David Karlin, QL Advanced 
User Guide by Adrian 
Dickens, or Advanced QL 
Machine Code by Adam 
Denning. Adrian and Adam 
probably got much of their 
information originally from 
Tony and David (Tony wrote 
Qdos in the first place!) 
However, Adrian and Adam 
have more in the way of 
examples and illustrations of 
how to use the code. (Much 
of what | know | learned 
from them) 


Two routine 
types 


There are far too many 





routines to explain in these 
articles. What | shall do is to 
go through a few of them to 
illustrate the different ways 
they can be accessed and 
used. 

The routines may be 
divided broadly into two 
types, which require rather 
different handling. These are 
the “vectored utilities” and 
the “trap calls”. For the 
moment we shall confine 
ourseves to vectored utilities. 

These routines are held in 
the rom, but different ver- 
sions of the rom have rou- 
tines which may be of differ- 
ent lengths, and held at dif- 
ferent addresses. So how 
can we write a program to 
use them which will auto- 
matically work whatever ver- 
sion of the QL we have? 

All versions of the QL rom 
have a set of words from 
address $CO to address 
$12B which contain the 
word addresses of the rou- 
tines. This set of words is 
called the “vector table’. 
What makes this so useful is 
that every version of the QL 
rom has the same location 
in the vector table for rou- 
tines which do the same 
job. This means that all your 
program has to do is use 
the vector table to find the 
address of the routine you 
want, and then use that 
address. As long as your 
program uses the correct 
location in vector table, it will 
access the correct routine, 
regardless of where it is held 
in the rom. 

This is a very important 
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point 
using vectored 
routines, and 
must be under- 
stood if they are 
to be accessed 
correctly. Let us 
look at an 
example, which 
will be used 
later in this. arti- 
cle. 

There is a 
routine in the 
rom which 
allows us to 
open a CON_ 
channel. The 
address of this routine is 
held at address $C6 in the 
vector table. (The value $C6 
is Known by the label 
UT_CON, and you may well 
find that your assembler will 


already accept the label - 


UT_CON in place of $C6) 
This much is true of all ver- 
sions of the QL. But the 
actual address of the routine 
itself, ie what we actually find 
at address $C6, might be 
different in different QLs. 
However, as long aS we use 
the address found at 
address $C6, we will get the 
routine we want. And when 
people decide to improve 
on the routines, they can 
ensure their new roms are 
compatible with existing QLs 
by keeping each rewritten 
routine’s new address at the 
same place in the vector 
table. Clever, isn't it? 


Address regis- 
ters 


since we know how to 
find the routine we want, 
there are various ways we 
might get at it But the usual 
way of doing it is to put the 
address of the vector table 
location into an address reg- 
ister. For example 


MOVEW $C6A2 


will put the vector table 
address (which holds the 
address at which the “open 
a CON_” channel routine 
can be found) into register 
A2. We can then go straight 
to the routine with the line 


about 


JSR (A2) 

The JSR stands for “jump 
to the subroutine”. A2 means 
we use the address in regis- 
ter A2. However, the brackets 
means that the data found 
at that address is itself an 
address, and that is the 
address we actually jump to. 

For these subroutines to 
work, they need to be given 
some data to start with, so 
they know exactly what to 
do. This is done by putting 
this data, in an appropriate 
form, into one or more regis- 
ters. 


CON_channel 


To open a CON_ channel 
requires border colour and 
width, ink and paper colours, 
window width and height, 
and x and y origins (top left 
corner). This data must be 
placed in a “parameter 
table” in the correct order, 
which is held somewhere in 
ram. The starting address of 
this table must be held in 
register Al before we jump 
to the routine. The exact for- 
mat of this table is 


byte border colour 
byte border width 

byte paper/strip colour 
byte ink colour 

word window width 
word window height 
word xorigin 

word = y origin 


lf all has been successful, 
the newly opened window 
will clear in the given paper 
colour, with a border of the 
given colour and width. Also 
register AO will contain the 
“channel ID" of the newly 
opened channel. This is 
rather like the channel num- 
bers used in SuperBasic 
when channels are opened, 
used, and closed. But they 
are not the same numbers, 
and are not interchangable. 
This channel ID is chosen 
by Qdos (unlike SuperBasic 
channel numbers, which are 
chosen by the programme). 
It must be carefully stored, 
because it will be needed 
every time we want to do 


anything with the channel, 
for example, resize or 
recolour, write text or draw 
lines, and of course close 
when we are finished with it. 


Channel ID 


Many routines expect to 
find the channel ID in regis- 
ter AO, so it can often be 
simply left where it is, as 
long as we can be certain it 
will not be overwritten before 
it needs to be used. You can 
also store it on the “stack’, 
which is normally the clever 
way of doing things, but can 
lead to complications if you 
are using the stack for other 
things at the same time. The 
safest thing to do is to allo- 
cate a space for it within 
your program, and store it 
there. This is a bit more 
cumbersome, and not the 
way experts usually do it, but 
at least you know exactly 
where the thing is whenever 
you need to us it again. 

But suppose something 
goes wrong. If, for example 
you give it an impossible 
size or position, the routine 
will be unable to open the 
channel. Does this mean 
your program will crash, 
which in the middle of a 
machine code routine often 
means the QL will hang up? 
Not if you handle things 
properly. 

All routines in the rom 
where there is any possibility 
of things going wrong pro- 
duce an “error return”. This is 
a number which appears in 
register DO on returning from 
the routine. If there is no 
error, the number zero will 
appear in DO. If an error 
does occur then a negative 
number will appear in DO, 
and the actual number will 
tell us what the error is. So 
by reading DO after the rou- 
tine is finished, we can find 
out if an error has occurred, 
and if it has, we can decide 
what action to take next, 
without the QL hanging up 
On US. 


Error message 





One very useful thing to 


Listing three 


19% REMark Sinclair QL World HEX LOADER v 3 


119 REMark by Marcus Jeffery & Simon N Goodwin 


120: 


13@ CLS: RESTORE :READ space:start=RESPR(space) 


14% PRINT “Loading Hex...":HEX_LOAD start 
15@ INPUT "Save to file...";f$ 


16% SBYTES f$,start,byte:STOP 


17@ : 


18@ DEFine FuNction DECIMAL(x) 


199 RETurn CODE(h$(x))—-48-7*(h$(x)>"9") 


2009 END DEFine DECIMAL 


2108 : 


229 DEFine PROCedure HEX_LOAD(start) 


239 byte=¢:checksum=@ 


249 REPeat load_hex_digits 


250 READ h$ 
26¢ IF h$="*":EXIT load_hex_digits 
270 IF LEN(h$) MOD 2 
PRINT "Odd number of hex digits in: ":h$ 


286 
296 


STOP 


300 END IF 
314 FOR b=1 TO LEN(h$) STEP 2 


326 
336 
349 
35 
369 
37D 
389 


41% READ 


hb=DECIMAL(b):1b=DECIMAL(b+1) 
IF hb<@ OR hb>15 OR 1b<@ OR 1b>15 


PRINT "Illegal hex digit in: ";h$:STOP 


END IF 


POKE start+byte,16*hb+lb 


checksum=checksum+16*hb+lb 


byte=byte+1 
39¢ END FOR b 
499 END REPeat load_hex_digits 


check 


429 IF check<>checksum 
436 PRINT "Checksum incorrect. Recheck data. ":STOP 
449 END IF 
456 PRINT “Checksum correct. Data entered at: ";start 


466 END DEFine HEX_LOAD 


479: 

48% REMark Space requirements for the machine code 

49% DATA 142 

50@ : 

519 DATA "43FA9946": REMark LEA.L CON,Al 
520 DATA "32C1"; REMark MOVE.W D1,(Al)+ 
5389 DATA "32C2": REMark MOVE.W -  —D2,(Al)+ 
549 DATA "32C3": REMark MOVE.W: D3,(A1l)+ 
55@ DATA "32C4": REMark MOVE.W D4,(A1l)+ 
569 DATA "82C5": REMark MOVE.W D5,(A1)+ 
570 DATA "32C6": REMark MOVE.W D6,(A1)+ 
580 DATA "43FA9636": REMark LEA.L CON,A1 
59% DATA "3478@@C6": REMark MOVEA.W $C6,A2 
600 DATA "4E92": REMark JSR (A2) 

61% DATA "@C4G099G": REMark CMPI.W $#90,Dd 
620 DATA "679A": REMark BEQ.S STORE 
630 DATA "3478G@CA": REMark MOVEA.W $CA,A2 
649 DATA "4E92": REMark JSR (A2) 

65% DATA "7696": REMark MOVEQ #$299,D9 
66% DATA "4E75": REMark RTS 

678 DATA "43FA@@22": REMark .STORE LEA.L ID,Al 
689 DATA "2288": REMark MOVE.L A@,(A1) 
699 DATA "438FA@@1C": REMark LEA.L ID,Al 
700 DATA "2051": REMark MOVEA.L {(A1),A@ 
716 DATA "48FA@@1A": REMark LEA.L TEXT,Al 
720 DATA "347866D@": REMark MOVEA.W $DG,Az2 
730 DATA "4E92": REMark JSR (A2) 

74% DATA "4E75": REMark RTS 

759 DATA "$690": REMark .CON DC.W DOOD 

768 DATA "$@@06": REMark DC.W DOOD 

77@ DATA "$99": REMark DC.W DODD 

78% DATA "$996": REMark DC.W DOOD 

798 DATA "$060": REMark DC.W DOOD 

890 DATA "$996": REMark DC.W DOOD 

819 DATA "$$969990":REMark .ID DCL DDBDGOBO 
820 DATA "@912":REMark -TEXT DC.W $12 

839 DATA "544849532049532941294D4553534147452¢": REMark DC.B 
840 DATA "*"\7224 


"THIS IS A MESSAGE " 


do is to write an error mes- 
sage in SuperBasic’s chan- 
nel #0 to tell us what went 
wrong. To do this we have a 
vectored routine called 
UT_ERRO with an address in 
the vector table of SCA. All 
this does is read the num- 
ber in register DO, and print 


an appropriate error mes- 
sage in #0. We can use this 
with, for example, the two 
lines 


MOVEW $CAA2 
JSR (A2) 


Having opened a chan- 


nel, we should to do some- 
thing with it, and the most 
common thing is to write 
some text. For this there is a 
vectored routine called 
UT_MTEXT with an address 
in the vector table of $DO. 
This routine expects to find 
the channel ID in register AO. 
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(As | mentioned, if a routine 
is using a specific channel, 
it expects to find the chan- 
nel ID in AO) It also expects 
to find the address where 
the text to be written is 
stored in register A1. But 
this must be stored in a 
special format. 

The first word contains 
the number of characters to 
be written. A mistake in this 
number will lead to some 
characters left off the end, 
or some gibberish tagged 
onto the end. The number 
is followed by the actual 
characters to be printed. 


A program 


That's enough new theo- 
ry for now. Let’s put it to 
work by producing a pro- 
gram to open a channel 
and print some text in it. In 
order to make it interactive 
(that is, so that we can play 
around with it from the key- 
board while the program Is 
running), we shall write it so 
that the channel parame- 
ters can be input from the 
keyboard in SuperBasic. 
You should recall that the 
SuperBasic CALL com- 
mand will accept extra 
parameters which are put 
into registers before the 
routine is run. We can use 
this to put the channel 
parameters into the pro- 
gram. 

Listing one shows our 
assembler program. We 
start by using the LEA 
instruction to put the 
address of the parameter 
table in register A1. By look- 
ing further down the listing, 
you can see the label CON 
is the first address of the 
space put aside for the 
channel parameters. At the 
moment it contains nothing 
but zeros. But if we use the 
CALL parameters correctly 
from SuperBasic, then reg- 
isters D1 to D6 will contain 
the data for the channel 
parameter table. So we can 
now fill the parameter table 
from the registers with a 
series of post-incremented 


MOVE instructions. This 
means that after each 
MOVE instruction, register 
Ai will contain the address 
for the next parameter. 
Before we can use the 
UT_CON routine, we need 
to restore register Al to 
point to the start of the 
parameter table with anoth- 
er LEA instruction. After this 
we can attempt to open the 
channel with the two lines 
mentioned earlier. 


Successful? 


We next want to know if 
we have been successful. 
By using the CMPI instruc- 
tion we can find out if regis- 
ter DO contains zero. If it 
does, the routine was_ Suc- 
cessful, and we jump to 
two lines which store the 
new channel ID in a ram 
location put aside for it. (In 
this particular program, this 
step is not actually needed, 
because we are going to 
use the channel ID in regis- 
ter Al before it has a 
chance of being corrupted. 
But in a longer program, 
where the channel ID might 
be needed many times, it 
needs to be stored safely, 
sO we are doing it here for 
the sake of good parctice)) 

lf DO contains anything 
but zero, it means an error 
occured and the channel 
was not opened. So the 
program goes straight on 
to the next two lines which 
orint an error message in 
#0. Having printed the error 
message, we need to know 
what to do next. In a more 
complicated program we 
may wish to jump back to 
an earlier stage in the pro- 
gram to try to correct the 
error. But in this program, 
this cannot be done from 
within the machine code, 
so there is nothing left but 
to use RTS to return to 
SuperBasic. Before we do 
this, we put a zero in regis- 
ter DO so that we do not 
get another error message 
on returning to SuperBasic. 
(Again, if you are following 
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this closely, you will realise 
that as the return to 
SuperBasic will print the 
error message for us, there 
is no need to use the 
UT_ERRO routine. We could 
have simply left the error 
return in DO and _ let 
SuperBasic print the error 
message for us. However, 
in general, we probably 
would not want to abort the 
machine. code in this way, 
so it is worth while knowing 
about using the UT_ERRO 
routine) 


Writing text 


Having a channel in 
which to write text, we can 
now do just that. First we 
use the LEA instruction to 
fetch the address of the 
channel ID into register A1, 
and then use it to MOVE 
the channel ID into register 
AO where it is needed. (In 
this program this is not 
needed, because the chan- 
nel ID is already there, but 
in general we will normally 
need to put the channel ID 
back into AO before we can 
continue.) Next, we load the 
address of the text into Al, 
before using the two lines 
needed to access the 
UT_MTEXT routine to print 
the text. 

Finally, we return to 
SuperBasic with an RTS. 

Listing two is a 
SuperBasic program to run 
the machine code. It 
assumes the machine 
code. is inea_ file 
LISTING1_code in drive 
flo2_. You may need to alter 
this to suit your system. It 
then goes into a loop 
which first asks if you with 
to open a channel and 
write text. If you don’t the 
program will stop. If you do, 
it will request input of the 
channel parameters, and 
then use them as CALL 
parameters for the machine 
code. You will notice that 
parameters which are suc- 
cessive bytes have been 
combined to make words. 

It is worth noting that the 


program commits the sin of 
never closing channels, so 
if you use it enough times 
without resetting the QL, 
you will eventually run out 
of spaces for storing chan- 
nel IDs. We have done this 
because closing channels 
requires a different tech- 
nique, and we shall look at 
this next time. 


Random chan- 
nels 


Having got the program 
to run successfully, you 
should try experimenting 
with it. You can do the obvi- 
ous things, like changing 
the text to be printed, or 
perhaps set up the 
SuperBasic loop to continu- 
ously print in randomly 
generated channels. It is 
worth experimenting to see 
how error codes work. You 
can deliberately use impos- 
sible parameters and see 
what error message it 
gives. More interestingly, 
you can try deleting the 
RTS line which aborts the 
program when an error 
occurs, and, using impossi- 
ble parameters so a chan- 
nel does not open, and see 
what happens. Surprisingly, 
the program may still print 
the text on the screen. 

There are other vectored 
utilities which can be quite 
useful for the beginner, 
although most do require a 
bit more expertise to get 
grips with. However to list 
them all together with 
exactly what they do, what 
parameters they need and 
where they are needed is 
far more than this article 
can run to. If you are really 
interested in using vectored 
routines then you ought to 
get one of the published 
books on machine code. 

As before, listing three 
contains the code in 
Marcus and Simon’s Hex 
Loader for those who do 
not have an assembler. 


Happy coding! 


Uitraprint 1.88 


Bryan Davies tests a high-spec screen dump utility. 





This program is a screen- 
dump utility. Commands for 
dumping the screen are built 
into some interface cards, and it 
might seem unnecessary to 
employ a separate program to 
do the job. Even so, printing 
what is displayed on the screen 
is not as straightforward as it 
should be. Some users will not 
wish to delve into descriptions 
of SuperBasic extensions to find 
the necessary command, any- 
way. If it does what is required of 
it, Ultraprint would be a worth- 
while accessory for anyone 
wanting to dump screen images 
to a printer at anything more 
than odd intervals, 

In my own experience, the 
three things the built in Trump 
Card and Gold Card SDUMP 
command does not do ade- 
quately are: 


i) print all four of the Mode4 
colours, in the Fx-80 mode, 

li) allow easy adjustment of the 
printed image size, and 

ii) work regardless of whatev- 
er else is running. 


The first point was a sore one 
for years, until experimentation 
with the SDUMP parameters 
yielded a solution. One of the 
four colours (green) would not 
orint out; every time a screen 


dump was needed to illustrate a 
program review, it was neces- 
sary to fiddle with the RECOL 
command to try and get sec- 
tions of screens to print out The 
review program would often kill 
the effects of RECOL before a 
print could be made. The 
answer was to set the com- 
mand to print to a different type 
of printer (Epson LQ-2500), This 
would not work for many users, 
who do not have a printer that 
can emulate this particular one. 
A problem with the RECOL 
command is that you have to be 
able to step out to SuperBasic 
to use it, and some programs 
(such as Quill) prevent that. Its 
effectiveness depends upon the 
program concerned not issuing 
any INK or PAPER commands 
to upset the RECOL settings 
subsequently. 


Not green 
What the basic reason for 


ignoring green is, | do not know, 
but Ultraprint missed it out the 


EXT 


same way as the interface dump 
command does, when run in 
Epson FX-80 mode. Setting the 
orinter to LQ-2500 mode 
enables green areas to be print 
ed, by both Ultraprint and the 
interface dump. In this respect, 
Ultraprint did not meet one of 
the three criteria stated above, 
but it may be that there is some- 
thing fundamental to an FX-80 - 
or to FX-80 printer drivers - that 
prevents green being “seen”. 
Figure one shows the screen 
with the file selection menu dis- 
played. The third of the supplied 
images (identified as “C’) is in the 
background of this illustration, 
behind the file-selection menu. 
This print was produced by the 
Gold Card interface SDUMP 
command, not by Ultraprint itself, 
since Ultraprint is not designed 
to capture “live” images of the 
screen, You do not have to go 
to SuperBasic to get a directory, 
as the program itself lists those 
files which it can print Up to 10 
files are listed in one window, 
with any remaining ones being 


available through presses of the 
cursor keys. 

Rather more functionality is 
available from the interface 
SDUMP command when the 
QUump Pointer Interface is used. 
It is possible with this to dump 
an area, or a window within that 
area, saved by the PSAVE com- 
mand. It does not look possible 
to vary the size of the whole 
screen image, however. These 
features are not available on the 
basic QL, even with an interface 
card fitted, unless the Pointer 
Interface is loaded, In this 
respect, Ultraprint certainly 
scores, allowing the whole 
image to be re-sized. An impor- 
tant factor for many users is the 
comparative lack of study need- 
ed to be able to obtain satisfac- 
tory prints with Ultraprint 


Affirmative 


Adding together the various 
points, there appears to be 
room for this separate screen 
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dump program. 

Ultraprint is supplied on either 
cartridge or disk, whichever is 
requested. A working copy of 
the disk version can be made 
with a copying command, such 
as WCOPY. A clone program is 
provided for cartridge users to 
make a copy. One other differ- 
ence between cartridge and 
disk versions is that the disk ver- 
sion has three screen dump 
routines on it - one for.Epson 
printers, two for OKI printers 
(recent, and older, models) - 
whereas the cartridge version 
has only the Epson routine. This 
is because there is not enough 
space on cartridge to hold the 
OKI routines too, but you can 
order them instead of the Epson 
one. The routine name is 
SDUMP, the same as the Trump 
Card or Gold Card command. 

The program can be multi- 
tasked (using Ctrl-C for switch- 
ing) with other programs. It is 
Turbo-compiled, and requires 
some SuperBasic extensions, 
which are loaded automatically 
by the supplied boot routine. 
There are two extensions files, 
taking a total of just over 10 KB. 
The SDUMP routine itself takes 
about 23 KB. 





Printing can be to either of the 
serial (the standard) ports, or to 
a parallel port The latter will be 
available only on a few disk 
interfaces. Files to be printed 
can be taken from the devices 
may, flo, fdk and ram. An addi- 
tional item on the device selec- 
tion menu allows the free mem- 
ory to be checked. 


Paperwork sup- 
port 


The printed instructions cover 
12 sides of A4 paper - a surpris- 
ing amount for a single routine. 
In addition, there is an 
UPDATES.DOC file on the pro- 
gram disk, containing informa- 
tion not in the printed instruc- 
tions. Fortunately, the updates 
with the review copy were brief - 
SDUMP now has a full-colour 
inversion facility, there are a COU- 
ole of errors in a test program 


Jine, and OKI owners using 


microdrives are advised how to 
obtain the routine for older (eg 
82A and 838A) models. The 
instructions are comprehensive 
and should be sufficient for 
almost all users. 

There is a one-page section 
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on multitasking, explaining how 
to run more than one copy of 
Ultraprint simultaneously with 
other programs. Printing is a 
slow operation at the best of 
times, and it is useful to be able 
to let Ultraprint get on with the 
job(s) while you do something 
else, such as writing a letter in 
your favourite WP program. It is 
pointed out that multi-tasking Is 
no “free ride’, though, and every- 
thing gets slower and slower as 
you run more and more jobs at 
one time. The Ultraprint screen 
may be confused when you 
switch back to it from another 
job but it can be refreshed by 
pressing any key. 

Nearly two pages are OCCu- 
pied with advice on possible 
error messages from the pro- 
gram, and a further page and a 
half deal with trouble-shooting 
orinter problems. A simple test is 
suggested for Epson compatibil- 
ity - if your printer prints correct- 
ly from Easel with the standard, 
Epson printer driver, it is Epson- 
compatible. The last two pages 
of the instructions give 
SuperBasic listings for four tests, 
to determine the Epson-and/or 
OKI compatibility of printers. 
Likely users of Ultraprint include 
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people who have Eye-Q, and it 
is pointed out for these users 
that any file which is not exactly 
32 KB in size will be loaded into 
Ultraprint by “compression load- 
ing” if partial screens are saved 
to file from Eye-Q, the com- 
pressed mode should be used. 


Check files 


Three sample files are provid- 
ed to check operation. Files 
which are to be printed must 
have one of the three suffices 
_SCR, _PIC or _PCB. The user 
just rename existing files, to give 


‘them one of these suffices, in 


order for SDUMP to find them. 
This makes the point that the 
orogram does not allow the 
user to dump the screen direct- 
ly; screen images must be 
saved first. The instructions indi- 
cate that the dump is done from 
the memory image, not directly 
from the screen, but this state- 
ment might cause some confu- 
sion. If there is anything else on 
the screen, that may be printed 
as well as the stored image, To 
avoid unwanted material (Such 
as the date and memory indica- 
tors which normally appear on 
my screen) turning up on the 
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orintout, get rid of them before 
using Ultraprint 

The program can be used 
with printer tyoes other than dot- 
matrix, but anything that does 
not print strip-by-strio may stop 
with an error message part-way 
through printing. For instance, 
my Epson GQ-5000 laser print- 
er, working in FX-80 emulation 
mode, gave “buffer full” errors 
and took 2-3 runs to print single, 
minimum-sized images. This 
results in misalignment of the 
different sections of the image, 
as can be seen in Figure two 
of the “normal” printed circuit 
board layout. This print was 
done in inverse mode (compare 
it with Figure one), All the illustra- 
tions were actually done using 
the printer's LQ-2500 emulation 
mode. The reason for this was 
the one stated above to ensure 
coloured areas were not missed 
out - not because there was any 
improvement in quality. 


Print modes 


Two basic print modes are 
available, “normal” and “special. 
The Normal mode will dump 
eight colours (including black 
and white), representing them as 
shades of grey. There is a 
choice of three sizes, and 
images can be printed in nega- 
tive (inverted) form if required 
that way. The function keys F1- 


F5 are used to select the sizes, 
with Shift-F1-F5 giving the equiv- 
alent negative prints. The size 
increases with the function key 
number. An additional option, 
obtained with Ctrl-F1, gave 
greater contrast with the F1 size. 
The extra carriage width of 
Epson 100-series models can 
be utilised with the larger size, 
although a small section of the 
right-hand side of an image 
printed this way was “off the 
paper’, 

The Special mode is especial- 
ly for subjects requiring high 
contrast, such as the two printed 
circuit board samples supplied. 
There are three normal size 
options, obtained from F1-F3, 
with corresponding Shift keyings 
for inverse- colour prints. To 
make use of wide-carriage print 
ers, there are Ctrl-F1-F3 extend- 
ed size options, and their Ctrl- 
Shift-F1-F3 counterparts for 
inverse colours. With the correct 
choice of size option, PCB prints 
can be “camera- ready’. It is Sug- 
gested that Ultraprint be used in 
conjunction with DP’s Eye-Q 
graphics program, for CAD 
(computer-aided design) work. 
One of the sample pcb files was 
printed full-page A4, and the 
print was good, but | lost count 
of the number of times the 
paper had to go back into the 
printer to get the job done, and 
misalignment inevitably 


occurred with each re-insertion, 
This problem would not occur 
with a dmp printer, but the quali- 
ty would not be as good either. 


Line spacing 


There is a line spacing option, 
which allows corrections to be 
made for errors in shape, such 
as flattened circles. The thin 
white horizontal lines that spoil 
many dmp prints can be dimin- 
ished in size, or almost com- 
pletely removed, by suitable 
adjustment of the spacing. The 
increments used are 1/216- 
inch for Epson and 1/144-inch 
for OKI. There is also the usual 
option you get with DTP pro- 
grams, to print in 1 to 5 passes; 
this should be necessary only if 
the printer ribbon is producing 
faint images. 

A small change in the line 
spacing setting makes a big dif- 
ference in the height of the print 
The file from which Figure 
three was printed came from 
amongst those supplied with 
Professional Publisher. [he 
printed clock faces changed 
oroportion considerably with 
only a single-digit change in the 
setting; in this case, the setting 
was reduced from 5 to 4. The 
Special mode was used, and 
gave a much better print than 
the Normal mode, 

The width of the printed image 





can be varied from about 10 
cm to three times that. All test 
prints from the laser printer 
came out in landscape orienta- 
tion. Quite a lot of prints were 
started part-way down the 
paper, such that they could not 
be completed before the edge 
of the paper. This may have 
been a function of printing on 
the laser printer, as the second 
“slice” was usually printed in the 
correct position. It is assumed 
this would not happen with a 
dot-matrix printer. 


ED problem 


There can be a problem for 
users of ED disks, as the pro- 
gram rejected two of them, ini- 
tially with the message “device 
error’. Reading the instructions, it 
was clear that the reason for 
this was that the write-protect 
tab was set on the disks, and 
the program wants to write 
something to any disk it access- 
es (not a desirable practice, as 
far as the protection of valuable 
files is concerned). Once the 
disks had been unprotected, the 
program halted, indicating that 
the Dataspace needed to be 
increased, possibly because 
insufficient has been allowed for 
the information in an ED disk 
directory. Not all users have the 
Turbo compiler and can adjust 
Dataspace, and this weakness 
might rule out the use of ED 
disks for some people. The 
required image files had to be 
transferred to a DD disk This is 
unfortunate, since users of, for 
instance, Professional Publisher, 
are just the type of people who 
may use ED drives, as they are 
eminently suitable for holding 
the large volume of files associ- 
ated with DTP work. 


Conclusion 


Ultraprint is not designed to 
give prints superior to those you 
can get using the interface 
SDUMP command, but it does 
provide greater flexibility in size 
and proportion of the printed 
image. It also allows “off-line” 
printing of saved screen images. 
It is not priced at the rock-bot- 
tom end of the market, but is 
within range of many users. 
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REST OF 


WORLD 
£40.90 
(12 MONTHS) 


PLEASE SEND YOUR 
SUBSCRIPTION FORM TO 
SINCLAIR QL WORLD, 
THE BLUE BARN, TEW 
LANE, WOOTTON, 
ViV(0\@) Bis Ke lel ax @).<0)\ Fi 
OX71HA. 

TEL:0993 811181 

FAX:0993 811481 
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SINCLAIR OL WORLD 
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| WISH TO SUBSCRIBE TO 
SINCLAIR QL WORLD 

WE HAVE HAD TO RAISE THE 
COVER PRICE OF QLWORLD 
BUT WILL BE HOLDING LAST 
YEARS SUBSCRIPTION PRICE 
FOR THE IMMEDIATE FUTURE 
ONLY. 


Existing subscribers will not be affected. 
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PLEASE DEBIT MY CREDIT CARD ACCESS/VISA 
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EXPIRY DATE 

PLEASE SEND ME A 12 MONTH SUBSCRIPTION TO SINCLAIR 
QL WORLD. 
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SINCLAIR QL + twin floppy 
drives, 256k memory, Separate 
keyboard, many games £125 
0491 681821 


QL SYSTEM 2XQL's, Colour 
Monitor, 2x31/2" Disc Drives, 
Trumpcard, Serial 8056 Printer, 
Silver-reed plotter/printer. Psion 
llcm organiser, comms-link, 
Datapaks, Letter Organiser. QL 
s/w. taskmaster, Spellbound, 


Lightning, Technial, Finance etc. 


All Leads & Manuals. Buyer to 
collect £375 Tel: 051 726 9801 
(eve), 


QL unexpanded AH 
version PSU Psion software 
manual etc. Any offers 
Miracle Systems QL modem 
£20. Phone: John 0689 
855444 


JS QL, Metal case, PC 
keyboard and |/face, twin 3- 
1/2” d/drives and OPD 


m/drives, some software, new 


colour monitor £250 ono. 
Also Tandata modem 3, 
CQVI Digitiser and more. Tel: 
(Derby) 0332 677746 


QL unexpanded JM 
version, shinwa CPA 80Q 
printer, joystick, Software 
including Psion suite, Eye-Q 
and Games, 40 MDV's, 
Manuals etc, £150 Tel:0256 
764006 evenings only 


QL Minerva Rom,Trump 
Card 3-1/2” D/D,Miracle 
centronics (x2) Tandata 
modem,serial printer, 6 years 
QLWorld, Quanta mags, 
books, software, b/w 
television extra MDV. 
Sensible offers please. Tel: 
0977 515428 


WITH REGRET, Offers for 
complete QL System. Two 
Computers 14° colour 
monitor, double disk drive, 
ice, Original software plus 


more. Books, Manuals. Psion. 


organiser and printer. Phone 
for details 0257 265700 
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COMBINES 
Sound logic with A.I. to win £ hundreds £ 
Analysis of Bookies Factors for matches 


Common sense improves chances of Mega-Win 


UNIQUE ENTRY SYSTEM 
Takes only a few minutes each week 
Over 300 teams in data-bank. 
Minor league teams automatically added. 
Prior to PC release @ £99.00 
To QL users offered at SPECIAL PRICE £49 
THIS MONTH 


MONEY BACK GUARANTEE - Make a profit in your first full season or 


your money back. 


256K ROM minimum. Discs Only. State 3.5 or 5.25 
CHEQUE OR P.O. TO S.CANTON, OCEAN COMPUTER SERVICES, PO 


BOX 68, NORTH DO. Manchester M8 6NJ 
Tel. 061 740 9002 





Please send coupon to: Advertising Department Sinclair/QL World, The Blue 
Barn, Wootton, Woodstock, Oxon, OX7 1HA. Please place this Classified 
Advertisement in the next issue of Sincair/QL world, 


| enclose a cheque/P.O. to the 
value of £17.65 (inc. VAT) for a 
lineage advertisement of no 
more than 30 words. Please 
make cheques payable to: 
Arcwind Ltd. 
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DATABASE SOFTWARE 
COCKTAILS WAITER£10 00 
DATA DESIG 3 sescssscssssutieljesistciasgsiaasssentstbetsades £60.00 
DATA DESIGN APT scescescscssssviitesissscnccesiesttciicieuvevitvcti £20.00 
tS: a ne ae ee £15.00 
DEP IONGS,  cccssscccsscenssasiesiteciesasitreasimeccammmnianaiotane £15.00 
FLASHBACK,  accunumunnmmasaanswiantmusinesale £25.00 
FLASHBACK SE... ccccivencconsectctitetiondliiinintund tid £40.00 
SUPER DISK INDEXER  ssccsssccctsvcessssscasssintstscusisincstavies £12.00 
DTP & CLIPART 
PAGE DESIGNER 3 sciccihcesthbcsutcthatasduscrensttascemmsenansoatl £40.00 
Available at last! 
UPGRADE FROM PD 2 :ssccsotssvssssncercncssccsissivtenstinsasionst £25.00 
SCANNED GLIPARL 1G)  scssssassosesstassossscraparesamnsicne £10.00 
SCANNED 'CEIPART 2 GD. ccosecrsesssrensesrverensseovenpernsens £10.00 
THE CLIBART (I) cccccascestitustsensaneindeieoatbearianien £12.00 
FILE HANDLING 
LBS OL RS) 2’ CROONER Ee: Ble RON REae ee EOE £12.00 
Pid 9 one Somali Re ec AOC ATS £12.00 
AMATTER & LOCKSMITHE escsssssssssssvssossesonsssosesennes £23.50 
FES LEE | | | a ec ae £14.95 
NMIDV TOOLGHEEST sissssinicsscsssssssnnssincsnsetcstecteccpntonienes £14.95 
DEES OOPEIER UD :ssvinssascssnscnosscissasssessunissaissansissstasissi £12.00 
FE EENCIROL, Wccstinsasenitelstioannenemtanntunsaltecaionvaes £25.00 
FILE TRANSFER 
PR gC: I ce: ae Tee £10.00 
JE eo: Ce £20.00 
MUL TICDISCOVER.  ssvssssssnscsssssacssiniisssaisssicsssestssiinssiansnins £30.00 
OPTI TRG IIGN GE ..cssssssrvsscssssssranesascesssipirsorerisieonth £15.00 
COLAC FILES. conewessnsseenenratesereoraesmeeverowers £24.50 
BL ODL: scessssnssateateresstssanstadienscseigpsicissiees peaibbeteicnsntmilis £24.50 
P9010 Ie. £15.00 
GAMES & LEISURE 
FIVE GAMEN PACK (U). ssssasissiccsacssetessssenssnvsovnesinesosiiens £12.50 
FLEET TACTICAL COMMAND (U) .esesssssssssssssessosse: £39.95 
TGA PRINTER vieisscsssassestesionssanctacsosanisassiasinessssonssies £9.95 
PLAGE TECK ) ' sccssssessssnssssssoninnssinivisaeesnsnsiasssesiossstoni £15.00 
PRS LS Te £9.95 
EAD (OO Anes eo a eee £12.50 
OPEN COIR Sere tscsssansssavsanscsarnsvenisssnsstasensingeinscsssiacion £12.50 
QUESTION MASTER (U)) ..ccveereovscsseseescossesesssoasesessosenee £10.00 
QUIZ MASTER ZiAU) scxccsesssiovosenesconteysssnssenntvecnmeepeesseses £12.50 
REFURN TO ELDEIN  ccscsninovisioscserssvssiaesinsasskisidacssincenies £17.50 
SO) 01010) 20) | 2 a £15.00 
SQUIDGY ROUND THE WORLD (U) eccrcsvsssssssvseee £12.50 
LABELLING 
ADDRESS BOOK&LABEL PRINTER esssssssssssesservees £15.00 
SUPER DE SRCEABILLLR. <cctovnesestonccvorsssneenecstesessenses £10.00 





Dilwyn Jones Computing 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 
GWYNEDD, LL57 3YT, GREAT BRITAIN 
FAX/TEL: (0248) 354023 


GENEALOGY 
GENEALOGIST 3. scxiasccsstscosssnecsssccinsevmencevesvesesisonscsivs £60.00 
new pointer driven version 

UCigheide 210k GUHA | scsecesseiiessesinecossvesscsesensessivenincvins £33.00 
upgrade other versions, ask 

GENEALOGIST 2ND EDITION .ecsssssssssssscssnsesssssesees £30.00 
BUDGET 128K GENEALOGIST (U.ccsssssscssssssssseseen £12.00 
GRAPHICS 
TMEAGIED (U): sscscccesssssiessopssiiesissaseiaiassccsvseanscsvssnianccevtstes £10.00 
TAGE PROCESSOR, wnsesencnssenemnasnmnvnncnansnvenst £15.00 
LINE DESIGN sccscsicscssnccacetuscinscanccsionusits £100.00 
PAINTER sssnvcwnennsvevnsssviecneniennisenimiennnincgenntiiel £25.00 
PICTOREMASTER:  cnsceeriiecseameccsenssecsisetetumepunnsn £15.00 
PICTUREMASTER PLUS .ecsssovssssssssssscsossssessovsssssenssaves £20.00 
CRACTAL  svicsssscucessossricsssotnssssovnncssobetansinsvonssenssinccoivibiagyiets £20.00 
QUICK MANDELBROT 3 (U) eesccssssssssssssssssssserneneen£ 15.00 
SCREEN COMPRESSION ossccsscescossscscossescossssssvscessssces £10.00 
SCREEN SNATCHER (U) scsisicsssccoscoesssssssestoosessnitsoeoves £10.00 
SIMPLE VIDEO TETTES - .cvccccsosesascssecssoneseonseesorevereeccesees £5.00 
TAI UI cassie ct catess cscssshninin naonbscnenineincnenitenivi £10.00 
HARDWARE 
MICRO PROCESS CONTROLLER 

MEW redesigned VErSION .ssssssssessesssesssessssssscesssesessnecsesss £64.50 
DEBE SORE WARE cctv scoossceoneczeepecornveqsoereneoonioeneysiorseonsett £9.95 


NETWORK PROVER cccssccscoccccovcovssseerocorsorsvsssorssssoossssossesste 4,00 
QPOWER REGULATOR csssssosssnssssssosorsosnsrsesneesrennee 24,95 
(unsuitable Gold Card) 


VOICE ANALYSER-New! 

Ask for details and price 

Add £2 50 postage for MPC, 
SERMOUSE AND VOICE ANALYSER 


QREVIEW 

OL TECHNICAL REVIEW. ssssssssisisssonssssssiessassievsssanisases £2.00 
issues 1-8 available 

QL ADVENTURER’S FORUM ..esssssesssesssvssseessersseessesee£ de 75 
Issues 1-9 available 


OL LEISURE REVIEW sccsvisvessncssesccceiassssssssasyscepssonsvetsiens £2.00 
issues 1-2 available 

(UK prices only shown) 

PROGRAMMING 

BASIC REPORTER (GD  ssinisevsicrreneninticieiomitentievinit £10.00 
DISA ssascscscccsinsyslocssiceausssnssiisistiistsaiasssialacassunniiicea £29.00 
PLE a. 5 (fe ae £10.00 
PONV ELE EE | 5 ce ne £40.50 
EASVPAR 3 DARL 2 iccssccccsssssscisunsciciiaanscievvniiciataceante £20.00 
EASYPIR 3. PART 8. scscssssvsccsssinissssiiaisssisissssscnsetissisins £20.00 
MEGATOOLKIT DISK (G) sssessscssinsssssssssvensvsoovsssssosses £25.00 
MEGATOOLKIT EPROM (U) avessoseesssosssvessssesceneessseees £40.00 
OL TREAT ORNS SG secnrecontorneesessinnenmonsneleersaninnnnt ae 
BUDGET QLIBERATOR (U) ccsecscsesesssssocsscssscssessoneeceeee £25.00 
QLOAD AND QREF (U) svecssscossesssscessssnsssessereseeeeerereene 15.00 
Ie Orr EEL Ok CIT coeseshinscnetibaniaiinadehneiseasinisaniai £20.00 





SCREEN DUMPS 

SIDEWINDER PLUS scssssscsnsssssnnscescisossssrssssasuisuastssssi £24.95 
SPREADSHEET PRINTING 

EERSTE TOPS (0) asneseresiiecienintaenmncerenneessetenmmesintineanneniea’ £15.00 
SDD TERRAIN  .sssvesosssssrssisosssncesssessetulsoteonnesssedateessonteaectovion £12.50 
SUNDRIES 

3 5” DSDD DISKS CCI: sssvscsssssassssrissunsinsosssnscissntsicsioon £0.40 
3 5” DSHD DISKS CGH sossiscssoosssesoressoeseesorenseesassesstesien £0.70 
3 5” DISK LABELS (FOI! 100) oscocsescsocsscosesssorsoosseoeese £2.00 
FS” LABELS (printer rll) cccsnisosoorosssosevssesensinscosssseene £2.50 
ADDRESS LABELS (roll 100) .ssssomscsssesscessescesssesseesess £2.00 
MICRODRIVE CARTRIDGES . .ccsssesscossssssssorsssesesennsveees £2.50 
MDV- LABELS (roll LOO) sasisescscasssnsicosssisecsonsssosbinitiansiars £2.00 
MIQUISE MAT scosarcsessscoronssseisisisvessinessensumenescnnmnseqreonesh £2.50 
FS” DIRK DIVIDERS (20 seemerersmonrorneosoneorereresonrroernroe £3.00 


Add £0 50 postage for labels or mouse 
mat if only ordering those, or £2 50 postage 
for disks or disk box divider sets 


QUICK: POSTERS (CG) sssssscsssisscovovessvevsesssawstessavevsloveisosis £10.00 
ROB ROY PACK. (0) cccacessssscessssnisrissvsnseniasssessassssincoones £10.00 
SPELL BOUND? Ssuvcisccchetsebsicocssseltssntovssiectetevitecisseltviviae £30.00 
SPEELLEGUND GE, sssnenpcsmencmmesnmnnnspepumpansny £50.00 
TEXTIDY seco ticsasevsat asevisvansdlscesepstnciasetniaancbuiinsinisciatbee £15.00 
TEXT 'N* GRAPHIIX  ssoisccrnvesineisslelestiivnlpevivatieshaiyesttiatte £20.00 
OTHER SOFTWARE 

HOME: BUDGET () sistavisscrirsnnrssensnivitrivtrsrcesieccne 2000 
PRINTERMASTER (O) ccssarscssssssscscmnersivesessneonenenseies £20.00 
CPIEEE F —ccslls Mlassstenincnscnisasnecemanenicconeneinonntiemennniiiaaiae £19.95 
IO OIE: Sisscaiinsutesbiseaacecoilaas ooeienattanieeupieasaasbbuiisemnmaissttaaiaed £39.95 
THE Pointer Environment package! 

OTOP. rsmninnmninmmnnnmnniamansennas £29.95 
SCREEN ‘DAZZLER, scssiscssssssnssssscissuhssiassosssonssonaslorieetes £15.00 
SCREEN ECONOMISER (U) ssecsovsscosovssssssnssescovsssssees £10.00 
EOE 1S OL, 1) ee Se nee £5.00 


CALL OR WRITE FOR A FREE COPY OF 
OUR QL SOFTWARE CATALOGUE 
DETAILING AROUND 100 QL PRODUCTS 


PLEASE NOTE: (U) ABOVE MEANS THAT 
THE SOFTWARE IS SUITABLE FOR USE 
ON A 128K QL 


TERMS: POSTAGE-software sent post free to UK, overseas add £1 00 per program (maximum £3 00) Floppy disks, SERmouse, etc add £2 50 postage (see 
above) PAYMENT - IN UK currency (pounds sterling) only, please Valid methods of payment are cheque drawn on UK branch of bank or building 
society, Eurocheque, Postal Order, cash (send by registered posi or by credit card - Visa, Access, Mastercard and Eurocard accepted Please make cheques 
etc payable to DILWYN JONES COMPUTING Minimum order value £5 00 (due to bank charges) Goods remain property of Dilwyn Jones Computing 


until paid for in full Orders normally sent out within a few days of receipt, we will attempt to advise if any delay anticipated due to stock problems Orders 
can be accepted by telephone if paid for with credit card Orders paid with credit card can only be sent to cardholder's address under card company rules 
FAX - We now have a Fax machine on our usual number (0248) 354023 





